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
raising error when no descriptor element is found in registry during dereferencing
addressed PR comments
minor update
Merge pull request #194 from mdsol/dereferencer_bug_fix

raising error when no descriptor element is found in registry during der...
meaningful warning message in #source
top-level self link instead of profile
address comments and add rails middleware documentation