docs(*): refactor and reorganize

Reorganize the docs to make more sense for users.
Merge pull request #1172 from deis/docs_restructuring

docs(*): refactor and reorganize
docs(*): fix toctree