Feature/config and options documentation

@brutski Please review and merge.

This PR consolidates and restructures documentation and fixes some YARD issues.

It does not need to be review for content as a future PR will contain pertinent edits. Wanted to get the broad strokes done to make it easier to review the actual edits to content in a future PR.

Only merge after merging: https://github.com/mdsol/crichton/pull/181
I guess, yaml snippet should end here. Entire document below is rendered as yaml snippet.