Source repo for Docker's Documentation
Go to file
Alexis Bellido 8a7af7a037 move note about VOLUME and host-dir to existing note 2016-12-11 11:23:44 -05:00
.github Update ISSUE_TEMPLATE.md 2016-10-21 13:51:36 -07:00
_data Fix TOC for ucp, dtr 2016-11-05 17:21:47 -07:00
_includes Delete rightnav.md 2016-10-10 21:54:01 -07:00
_layouts Add support for advisories 2016-11-04 18:02:28 -07:00
apidocs Merge pull request #436 from sanscontext/cloud-api 2016-11-04 16:46:24 -07:00
compose Merge pull request #152 from mstanleyjones/redirect_from 2016-11-04 17:34:27 -07:00
cs-engine Merge pull request #102 from mbentley/update-cs-install-docs 2016-11-05 15:48:04 -07:00
css Add search icon from local src 2016-10-11 01:52:41 -07:00
datacenter Remove aliases, add redirect_from 2016-11-05 20:47:37 -07:00
docker-cloud Update link-source.md 2016-11-04 17:31:30 -07:00
docker-for-mac Change instances of alias: to redirect_from: 2016-11-04 17:07:02 -07:00
docker-for-windows Change instances of alias: to redirect_from: 2016-11-04 17:07:02 -07:00
docker-hub Update index.md 2016-11-04 17:25:05 -07:00
docker-store Converges titles to imperative-form, front-matter based, and sentence-case (#438) 2016-11-04 15:38:40 -07:00
engine move note about VOLUME and host-dir to existing note 2016-12-11 11:23:44 -05:00
favicons Convert TOML to YAML, tweaks to work with Jekyll 2016-09-29 17:16:03 -07:00
fonts Convert TOML to YAML, tweaks to work with Jekyll 2016-09-29 17:16:03 -07:00
getting-started Converges titles to imperative-form, front-matter based, and sentence-case (#438) 2016-11-04 15:38:40 -07:00
images Add search icon from local src 2016-10-11 01:52:41 -07:00
js Fix for 404 bg object, right-nav 2016-10-11 01:00:32 -07:00
kitematic Converges titles to imperative-form, front-matter based, and sentence-case (#438) 2016-11-04 15:38:40 -07:00
machine Merge pull request #409 from mstanleyjones/fix_liquid_warnings 2016-11-04 16:11:50 -07:00
notary Converges titles to imperative-form, front-matter based, and sentence-case (#438) 2016-11-04 15:38:40 -07:00
opensource Change instances of alias: to redirect_from: 2016-11-04 17:07:02 -07:00
registry Change instances of alias: to redirect_from: 2016-11-04 17:07:02 -07:00
swarm Change instances of alias: to redirect_from: 2016-11-04 17:07:02 -07:00
toolbox Converges titles to imperative-form, front-matter based, and sentence-case (#438) 2016-11-04 15:38:40 -07:00
.NOT_EDITED_HERE.txt Update .NOT_EDITED_HERE.txt 2016-10-14 14:07:24 -07:00
.eslintignore Initial commit -f https://github.com/docker/mercury-ui 2016-09-28 14:39:20 -07:00
.gitignore Convert TOML to YAML, tweaks to work with Jekyll 2016-09-29 17:16:03 -07:00
.ruby-version Create .ruby-version 2016-11-05 13:30:21 -07:00
404.md Fix for .md URLs 2016-10-19 10:22:32 -07:00
Dockerfile Create subdirectory-based docs archive 2016-10-26 17:48:00 -07:00
Gemfile Create Gemfile 2016-11-05 13:30:38 -07:00
LICENSE Content rendering fixes 2016-09-30 01:51:56 -07:00
MIGRATION.md Add migration details 2016-09-30 10:20:01 -07:00
README.md absolute links to docs.docker.com are now relative links 2016-11-01 17:01:41 -07:00
_config.yml Update _config.yml 2016-11-04 13:50:37 -07:00
allpagelinks.md All page links 2016-09-30 14:13:15 -07:00
docker-compose.yml Add Compose file for development 2016-10-05 19:34:31 +01:00
docsarchive.md Converges titles to imperative-form, front-matter based, and sentence-case (#438) 2016-11-04 15:38:40 -07:00
googlecbe7fee896be512c.html Website verification 2016-10-10 15:55:09 -07:00
index.md Converges titles to imperative-form, front-matter based, and sentence-case (#438) 2016-11-04 15:38:40 -07:00
release-notes.md Converges titles to imperative-form, front-matter based, and sentence-case (#438) 2016-11-04 15:38:40 -07:00
robots.txt Creating robots.txt ahead of time 2016-10-27 12:34:58 -07:00
search.md Converges titles to imperative-form, front-matter based, and sentence-case (#438) 2016-11-04 15:38:40 -07:00
sitemap.xml Sitemap fix 2016-10-10 16:25:26 -07:00
sorry.md Converges titles to imperative-form, front-matter based, and sentence-case (#438) 2016-11-04 15:38:40 -07:00
thank-you-subscribing-docker-weekly.md Convert TOML to YAML, tweaks to work with Jekyll 2016-09-29 17:16:03 -07:00
toc.txt Convert TOML to YAML, tweaks to work with Jekyll 2016-09-29 17:16:03 -07:00

README.md

Docs @ Docker

Welcome to the repo for our documentation. This is the source for the URL served at https://docs.docker.com/.

Feel free to send us pull requests and file issues. Our docs are completely open source and we deeply appreciate contributions from our community!

Providing feedback

We really want your feedback, and we've made it easy. You can edit, rate, or file an issue at the bottom of every page on docs.docker.com.

Please only file issues about the documentation in this repository. One way to think about this is that you should file a bug here if your issue is that you don't see something that should be in the docs, or you see something incorrect or confusing in the docs.

  • If your problem is a general question about how to configure or use Docker, consider asking a question on https://forums.docker.com instead.

  • If you have an idea for a new feature or behavior change in a specific aspect of Docker, or have found a bug in part of Docker, please file that issue in the project's code repository.

Contributing

We value your documentation contributions, and we want to make it as easy as possible to work in this repository. One of the first things to decide is which branch to base your work on. If you get confused, just ask and we will help. If a reviewer realizes you have based your work on the wrong branch, we'll let you know so that you can rebase it.

Note: To contribute code to Docker projects, see the Contribution guidelines.

Overall doc improvements

Most commits will be made against the master branch. This include:

  • Conceptual and task-based information not specific to new features
  • Restructuring / rewriting
  • Doc bug fixing
  • Typos and grammar errors

One quirk of this project is that the master branch is where the live docs are published from, so upcoming features can't be documented there. See Specific new features for a project for how to document upcoming features. These feature branches will be periodically merged with master, so don't worry about fixing typos and documentation bugs there.

Do you enjoy creating graphics? Good graphics are key to great documentation, and we especially value contributions in this area.

Specific new features for a project

Our docs cover many projects which release at different times. If, and only if, your pull request relates to a currently unreleased feature of a project, base your work on that project's vnext branch. These branches were created by cloning master and then importing a project's master branch's docs into it (at the time of the migration), in a way that preserved the commit history. When a project has a release, its vnext branch will be merged into master and your work will be visible on docs.docker.com.

The following vnext branches currently exist:

Staging

You have three options:

  1. Clone this repo and run our staging container:

    git clone https://github.com/docker/docker.github.io.git
    cd docker.github.io
    docker-compose up
    

    If you haven't got Docker Compose installed, follow these installation instructions.

    The container runs in the background and incrementally rebuilds the site each time a file changes. You can keep your browser open to http://localhost:4000/ and refresh to see your changes. The container runs in the foreground, but you can use CTRL+C to get the command prompt back. To stop the container, issue the following command:

    docker-compose down
    
  2. Use Jekyll directly. Clone this repo, install Ruby 2.3 or higher (required), install the GitHub Pages Ruby gem, then run jekyll serve from within the directory.

    The jekyll serve process runs in the foreground, and starts a web server running on http://localhost:4000/ by default. To stop it, use CTRL+C. You can continue working in a second terminal and Jekyll will rebuild the website incrementally. Refresh the browser to preview your changes.

  3. Use Github Pages, with or without a local clone. Fork this repo in GitHub, change your fork's repository name to YOUR_GITHUB_USERNAME.github.io, and make changes to the Markdown files in your master branch. Browse to https://<YOUR_GITHUB_USERNAME>.github.io/ to preview the changes.

Important files

  • /_data/toc.yaml defines the left-hand navigation for the docs
  • /js/menu.js defines most of the docs-specific JS such as TOC generation and menu syncing
  • /css/documentation.css defines the docs-specific style rules
  • /_layouts/docs.html is the HTML template file, which defines the header and footer, and includes all the JS/CSS that serves the docs content

Relative linking for GitHub viewing

Feel free to link to ../foo.md so that the docs are readable in GitHub, but keep in mind that Jekyll templating notation {% such as this %} will render in raw text and not be processed. In general it's best to assume the docs are being read directly on docs.docker.com.

Style guide

If you have questions about how to write for Docker's documentation, please see the style guide. The style guide provides guidance about grammar, syntax, formatting, styling, language, or tone. If something isn't clear in the guide, please submit an issue to let us know or submit a pull request to help us improve it.

Generate the man pages

For information on generating man pages (short for manual page), see the README.md document in the man page directory in this project.

Code and documentation copyright 2016 Docker, inc, released under the Apache 2.0 license.