📝 Docs: Migrate /api docs or an equivalent from the old site to the new one #5309
Description
Documentation Request Checklist
- I have read and agree to Mocha's Code of Conduct and Contributing Guidelines
- I have searched for related issues and issues with the
faqlabel, but none matched my issue. - I want to provide a PR to resolve this
Overview
Right now, https://mochajs.org/api is an auto-generated API resource built on @mochajs/mocha-docdash - a fork of docdash. Users expect API docs for Mocha, so we'll need to include them in the new website.
I think we have three options:
- Finding a newer equivalent that integrates with Astro/Starlight
- Un-fork and work with docdash to get whatever features we need moved into docdash core
- Keep the existing
@mochajs/mocha-docdashfork & system
Those options are sorted in order of my personal preference 😄. Docdash hasn't had a push in 2 years and it's not exactly actively maintained. Projects like Typedoc are a good bit more supported. starlight-typedoc looks pretty great.
Proposal: let's move to starlight-typedoc?
Additional Info
No response