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.

text/html