Markdown generation from JSDoc comments

[da-kami]

The recommendation by the documentation spike is to use https://documentation.js.org/ for this.

[yosriady]

I'll pick this up.

[D4nte]

I'll pick this up.

You can assign it to yourself now that I added you to comit-network :)

[yosriady]

Alternatively https://doc.esdoc.org/github.com/esdoc/esdoc/, which seems to have better support for hand-written documentation.

[yosriady]

For typescript support, we may need:

• https://github.com/microsoft/tsdoc
• https://github.com/TypeStrong/typedoc

[da-kami]

Alternatively doc.esdoc.org/github.com/esdoc/esdoc, which seems to have better support for hand-written documentation.

Is markdown supported? (marked as PoC https://esdoc.org/manual/feature.html - https://github.com/esdoc/esdoc-plugins/tree/master/esdoc-publish-markdown-plugin)
We CAN opt for HTML integration as well, but the idea was to start with Markdown first.

[yosriady]

What I'm going to do is start by trying documentation.js and to see if it serves our use case. It does seem to support Typescript and may also have handwritten support.