Slight refactoring of documentation.

This addresses #80, but is only a first pass.
Merge pull request #90 from binford2k/issues/80/improve_documentation

Slight refactoring of documentation.