Edits and fixes based on review.

Docker-DCO-1.1-Signed-off-by: Fred Lifton <fred.lifton@docker.com> (github: fredlf)
I'm not sure about having links on headings but happy to accept if everybody agrees it's a good idea.