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 think we moved everything to Railtie. And this should be up by default. The same true for Alps profile response.
Should probably include documentation about configuring expiration for middleware in crichton.yml