Edits and revisions

Changes to bring into compliance with Docker style guide and Hub guidelines. Plus copy-edits for clarity and readability.
Merge branch 'clojure_edits' of https://github.com/fredlf/docs into clojure_edits