edits and make play well with YARD for fragments
clean up resource descriptors
clean up api descriptor documentation
clean up protocol descriptors
clean up lint docs
clean up data and transitions docs
clean up getting started docs
fix YARD warnings
add missing definiton
Remove TOCs which are redundant with YARD generated TOCs
update documentation file reference
break out options and add design doc placeholder
add missing yardopt file
address comments and add rails middleware documentation
Merge pull request #186 from mdsol/feature/amend_and_cleanup_documentation

Merged!