Container Best Practices Guide

Build Status Docs

A collaborative project to document container-based application architecture, creation and management. The built version of this source can be viewed at


Please refer to the asciidoc user's guide:

Before submitting a pull request:

  1. Compile the document, make html
  2. run make check to spellcheck the documents. Update personal dictionary file containers.dict with any non-English words.

Working with files

Compile docs from a container

Create local index.html file

sudo docker run --rm -it -v `pwd`:/documents/:Z asciidoctor/docker-asciidoctor make html

Clean up files

make clean

This removes all generated files.


make publish

Github serves HTML documents from the gh-pages branch. This command will push to the branch.

Spell check

aspell is used to spell check the document. This is run in a Travis job for all pull requests. Any non-English words should be added to containers.dict with your commit. Ensure make check passes.