Add support for Annotations

[econchick]

Related roadmap page

• Annotation object, as defined by annotationTypes in the RAML root, containing properties (all optional):
  • [ ] display_name
  • [ ] description
  • [ ] annotation_name
  • [ ] allow_multiple
  • [ ] allowed_targets
  • [ ] either properties, facets or nothing but defaults to string
• [ ] List of annotation objects, annotations, attacted to RootNode
• Annotation support for (ramlfications must look for () to parse assignments of annotations):
  • [ ] RootNode
  • [ ] Documentation
  • [ ] ResourceNode & its method(s)
  • [ ] Response
  • [ ] Body - both request and response
  • [ ] Data Types
  • [ ] Named Examples
  • [ ] ResourceTypeNode
  • [ ] TraitNode
  • [ ] SecurityScheme
  • [ ] Security Scheme Settings
  • [ ] Annotation Type Declaration (an annotation can have an annotation itself)
  • [ ] Library
  • [ ] Overlay
  • [ ] Extension
• Validate based on:
  • [ ] annotations must be defined in root of API, not anywhere else
  • [ ] annotations can only be applied to above objects (see "Annotation support for:")
  • [ ] if annotation is limited by allowed_targets, then make sure all applied annotations are only to that object type
  • [ ] annotations applied to a data type are not inherited when that data type is inherited
  • [ ] annotations applied to/within resource types or traits are also applied to the resource type, resource, or method that inherits it
• [ ] Documentation
• [ ] Test coverage