Update the docs and add some more information

Mostly style/formatting cleanup.  Added some information in a few places too.