Doc refresh

I'm updating the docs.  I'm simplifying the organization (IMO).  If anyone cares let me know and I'll walk them through it.
Would be nice for the code itself to have more comments like these, not just the code-blocks copied to the documentation. :)