Example Doclets

[paulj]

This PR introduces the ability to associate additional example files using doclet tags in the description.

For example, a component defined like the below will have the examples in extra.examples.md associated with it:

  /**
   * Component is described here.
   *
   * @example ./extra.examples.md
   */
  export default class SomeComponent extends React.Component {
    // ...
  }

[sapegin]

Thanks!

Can we reuse someting from this file?

[paulj]

@sapegin we actually do use the functionality from that file. The doclets are parsed with props.doclets = reactDocs.utils.docblock.getDoclets(props.description);, which ultimately lands in that file. I had to reproduce the regexp though, since that file doesn't provide any mechanism for stripping out the doclets from the description once they are parsed.

[sapegin]

Sorry, didn’t notice it.