jsdoc support

Here is a quick example, for the public AddonManager API

To use it for your own code:

  1. Check that JSDoc generates the output you expect (you may need to use a @class annotation on “object initializer”-style class definitions for instance)

  2. Create an .rst file, which may contain explanatory text as well as the API docs. The minimum will look something like

    this

  3. Ensure your component is on the js_source_path here in the sphinx

    config: https://hg.mozilla.org/mozilla-central/file/72ee4800d415/tools/docs/conf.py#l46

  4. Run mach doc locally to generate the output and confirm that it looks correct.