add missing definiton
Remove TOCs which are redundant with YARD generated TOCs
update documentation file reference
break out options and add design doc placeholder