Replace APIDoc by @nuxt/content
Since we're using a websocket API now (via #666 (closed)) we have to ditch APIDoc since it's tailored for HTTP Apis (or adapt it to suit our needs, which is still doable, mind you)
So our choices are :
- Stick with APIDoc for low effort, and rewrite all API endpoints names. Not too difficult and it still will look okay.
- Switch to something like TSDoc to document the code itself but things might get lost in translation.
The thing is the API documentation is mainly used by frontend devs and right now we're the only ones (and have been for what, 3 years now) so I see little point to keep it up to date.
The variable names are fairly self explanatory and since we named the API WS commands better, they're also easier to understand than HTTP endpoints.
/discuss
Edited by Leon