Clean up documentation

@brutski Please review and merge.

This PR cleans up various documentation and links. Given @ChazzMaTazz will be doing a copy edit of all these changes when completed, there is only one file that you need to review for accuracy of content which is the getting_started.md files and the know_your_options.md files (the latter will have examples added in a future PR).

Otherwise, all the other file changes are just misc navigation fixes and reordering. Future PRs will complete documentation in designing state machines and examples for know your options.