Documentation Updates

The mega .raml file and a picture of the tree structure.
Assume that comments and descriptions can appear anywhere