message: chore: update development docs to explain usage docs generation
  ISSUES CLOSED:
diff: - [Pull Requests](#pull-requests)
  - [Releasing](#releasing)
  - [Code Comments](#code-comments)
  + - [Usage Docs](#usage-docs)
  - [Issues](#issues)
  <!-- END doctoc generated TOC please keep comment here to allow auto update -->
  @@ -297,6 +298,25 @@ machines.
  _always_ include the reason the note is needed. Remember, more information is better!
  +### Usage Docs
  +
  +Usage docs should be added to all components and directives. These docs are created by adding a markdown file named to match the component
  +or directive:
  +
  +```
  +// component:
  +foo.component.ts
  +// usage docs:
  +foo.component.md
  +```
  +
  +When the documentation published, this usage doc will be automatically consumed by the API docs generation.
  +
  +When editing or creating usage documentation, add headlines and appropriate content, then run `yarn run docs:toc` to update (or generate)
  +the table of contents.
  +
  +
  +
  ## Issues
  1. Always create an issue for things you work on. If it is worth spending time on, it is worth
  