docs(*): refactor and reorganize

Reorganize the docs to make more sense for users.

closes #921, #1050, #1141, #1075, #1160, #1140, #1084