[WIP] Reorg Docs

Going through the docs, updating things to match the reorg branch

I haven't even done spell check yet.  Be merciful.

Fixes #329
While it's nice to match the output of Python, this makes it annoying to copy/paste code snippets because of the '...' in there. Is it reasonable to exclude those?