More documentation cleanups

Still left to write is documenting the complete structure of the
`showoff.json` presentation configuration file.
Merge pull request #96 from binford2k/issues/80/improve_documentation

More documentation cleanups