The code-blocks did not include line-continuation (`\`) symbols, causing
the code-highlighter to treat them as "process output", which is excluded
from copying/selecting.
Also made some minor touch-ups in markdown while working on this page.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
The `hide_from_sitemap` metadata variable was a custom thing we implemented
to add a "noindex" meta-header to pages and to exclude a page from the
search auto-complete.
However, pages with that option set would still be included in sitemap.xml,
resulting in search engines to visit those pages (only to discover they
should not index them).
This patch replaces the custom `hide_from_sitemap` value for `sitemap: false`,
which is a metadata variable that's defined by the "jekyll-sitemap" plugin
we use to generate the sitemap.xml;
https://github.com/jekyll/jekyll-sitemap/blob/v1.4.0/README.md#exclusions
Setting this variable will now:
- add a "noindex" metadata header to the page
- exclude the page from the sitemap.xml.
- exclude the page from /js/metadata.json (used for search autocomplete)
Also fixed an issue in the metadata.json where the `notoc` metadata was
used to exclude pages, however that variable is meant to disable the
in-page TOC (right-hand side navigation with anchor links).
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
See https://web.dev/external-anchors-use-rel-noopener/
Using noopener, as that addresses the security issue. "noreferer" blocks
the REFERER header, which may still be useful for some target URLs.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Fix incorrect links in compose section
there's a bug causing wrapped links to not work, and replacing
some links to point to the .md file, so that IDE's can check
if the anchors are valid. Also replaced some links to point
to their new location.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* engine/swarm: update links
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Fix various broken links
There's a bug in the "jekyll-relative-links" plugin that causes wrapped links to not work.
Also replacing some links to point to the .md file, so that IDE's can check if the anchors
are valid. Finally, replaced some links to point to their new locations, so that users don't
get redirected..
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Reword lots of instances of 'will'
* Reword lots of instances of won't
* Reword lots of instances of we'll
* Eradicate you'll
* Eradicate 'be able to' type of phrases
* Eradicate 'unable to' type of phrases
* Eradicate 'has / have to' type of phrases
* Eradicate 'note that' type of phrases
* Eradicate 'in order to' type of phrases
* Redirect to official Chef and Puppet docs
* Eradicate gratuitous 'please'
* Reduce use of e.g.
* Reduce use of i.e.
* Reduce use of N.B.
* Get rid of 'sexagesimal' and correct some errors
* add more links and info re: Hyper-V driver for Docker Machine on Windows
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added info on where Machine data lives
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added information about the Hyper-V Manager
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* linked between docker-machine create command and other relevant topics
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* copyedits
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* copyedits, added Examples heading to create driver
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* clarifed docker-machine create example
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* updates to version variables for compose and machine
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* copyedit to make Compose release version number correct
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added more info re: Machine install commands on Windows
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* copyedits
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* review comments
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* more review comments
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* kicking the build, added metadata for search
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
Apple has changed their branding guidelines from 'OS X' to 'macOS'
so we should update ours to be within trademark / branding
guidelines. See http://www.apple.com/macos/sierra/
Signed-off-by: Misty Stanley-Jones <misty@docker.com>