Replace 'jsdoc-to-markdown' dev package dependency
Reference documentation is currently rendered via extremely hacky modification of jsdoc-to-markdown, which no longer even produces clean markdown, but a weird HTML/md hybrid monstrosity to fit our needs on the official website.
This package has proven to be EXCEEDINGLY painful to work with - especially being forced to use handlebar templates. I'd prefer if documentation was generated directly by the jsdoc package itself in HTML to our requirements, or eventually using its AST-like json output that can then be used by an in-house docgen system.
Ideal corrections:
-
First line in JSDoc should be automatically considered the @summary -
Summary should not display @summary tag, and should be included within the <summary>
element after the namespace. -
Properly group modules/submodules -
Custom handling for various custom values such as @private, @feedback, @quality, etc...
Edited by Lorin Halpert