This started as a "fix some links", but reading the section, I found various
issues that could use some improvement. After that, I noticed that both the
Windows and Mac pages had the same content, so I moved this to a common page
instead.
Note that there's still additional information that should likely be included
(and perhaps a rewrite into "per topic" headings (containers, images, ...).
Things that are missing;
- backup/restore swarmkit configs
- backup/restore swarmkit secrets
- backup/restore CLI configuration, trust data etc.
What I did in this pull request:
- recommend pushing images to Docker Hub as the default approach to back up
images (but kept `docker image save` as an alternative)
- recommend `docker container commit` to save containers to an image, as doing
so preserves both the container's configuration _and_ filesystem changes.
`docker container export` only preserves the filesystem, but all other
configuration is lost, which makes it hard to restore a container from it.
Using `docker container commit` (committing the container to an image) also
allows to follow the same procedure to backup containers as for images
(both allowing them to be pushed to a registry, or to a file).
- added some information about "wether or not" containers should be backed
up, as it may not be needed to back up containers if all data is stored
in volumes (best practice).
- added some warnings regarding "sensitive data" (environment variables),
and links to making repositories private before pushing.
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>
* Add mention of Learn menu, to re-turn tutorial
Signed-off-by: Charles Arehart <charlie@carehart.org>
* Minor style edits
* Update Mac Install
Add the 'Learn' option to the Mac install page
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
* - Added a new topic to describe how to install Desktop on Windows Home machines.
- Update installation instructions on Windows/Mac topics
- Removed references to Toolbox from the Install topics
- Updated the Install pages to add info on the new onboarding tutorial on startup
* Update docker-for-windows/install-windows-home.md
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
* Update docker-for-windows/install-windows-home.md
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
* Update docker-for-windows/install-windows-home.md
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
* Update docker-for-windows/install-windows-home.md
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
* move WSL 2 req above Hyper-V reqs
* Add info on purge container data
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
Unfortunately, the only reliable way to create internal links
is to use relative links to other Markdown files. This does
match the way links on GitHub work, but makes it harder to
create these links.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
- Move getting started overview to /get-started/overview/
- Move engine installation files under /engine/
- Redirect the top-level /install/ to /get-docker/
- Updated titles in left-hand navigation
- Added back some pages to the navigation that were
currently not included.
- Reduce some steps in the installation pages
- Move devicemapper prerequisites to the devicemapper
storage driver page.
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>
* Update install.md
What should the output of sysctl be?
* Updated the markdown formatting
Updated the markdown formatting and added text to explain the result.
* 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
Usha Mandya