Remove TypeDoc dependency

[donmccurdy]

Currently documentation is generated with TypeDoc. I'd like to switch to API Extractor for a few reasons:

• well-defined declarative JSON output
• easier to write/maintain a custom theme (see Upgrade to typedoc v0.20 #234)
• able to customize navigation without hand-writing each link
• hopefully more stable, have been hitting issues with TypeDoc historically, and had a major breaking change in patch release v0.21.3 with no fix planned

I think the idea here would be to:

1. Confirm I can get API Extractor JSON output for this monorepo.
2. Find or build an HTML/MD documentation generator (separate package)
3. Rewrite my theme for the generator
4. Put it all together

https://api-extractor.com/pages/setup/custom_docs/

---

Could also consider sticking with TypeDoc but switching to its JSON output mode. Most of the issues above are really complaints about the lack of a robust theming API.

• How do you generate your TypeScript docs? • Reddit
• Create Beautiful Documentation
• Generating Documentation for TypeScript Projects
• https://github.com/asakusuma/json-typescript-docs

[donmccurdy]

API Extractor does not currently track source code locations:

• [api-extractor] Optionally include source code coordinates in generated documentation microsoft/rushstack#895

Fixed:

• [api-extractor] Extract source file locations for relevant API items microsoft/rushstack#3590

Related:

https://elderguide.com/tech/elderjs/

[donmccurdy]

After some experiments with both API Extractor and TS Morph, I think TS Morph might be the more practical way to go here.