Updating docs - I consider this a finished first draft

Hopefully I can just check this in to master since I'm just updating rst files.  We shall see if I break anything.