Second draft of documentation.  Rewrite some examples, phrasing,
grammar and general formatting.