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
something wrong with API descriptor document link. 404 is returned. Here and elsewhere in README.md