docs(*): refactor and reorganize

Reorganize the docs to make more sense for users.

closes #1050, #1141