Inline API reference

[KnorpelSenf]

Work in progress.

Pending tasks:

• replace links to inlined API reference
• create TOC for each path, such as /api/core
• complete info for classes
  • include all class members
  • include links to source definitions
• add pages for all other types of exports (see commented out parts)
• decide how to handle clashes
• support /types.ts
• run deno fmt in order to make the doc styles more consistent (blocked by deno fmt strips whitespace from multiline strings inside link texts with "proseWrap": "preserve" denoland/deno#16730)
• fix GH links
• fix loads of details in the docs, such as link highlighting, cross-references between API objects, and likely a lot more
• Support @inheritdoc
• Replace links in other pages.
• Tell the reader what the API reference is.
• function overloads such as for webhookCallback are broken
• method overloads such as for Composer#filter are ugly
• properties defined via constructor parameters such as for Bot are not listed as properties
• properties defined via constructor parameters such as for Bot should get docs from the @param tags in the JSDoc comment of the constructor
• private properties are listed as public
• links from the JSDoc to the website need to be rewritten so that they do not open as external links
• something is very broken with InputMedia in types
• cross-package references such as RawApi in files/hydrateFiles currently 404
• Following direct links like this one will break the page layout upon navigation

[github-actions]

🚀 Deployed on https://65f76187c26572cafaaa2235--grammy.netlify.app

[KnorpelSenf]

https://635855ed09e68c00648923df--grammy.netlify.app/api/core/Bot.html

[KnorpelSenf]

https://6372cc78d06d6331bdcaae80--grammy.netlify.app/ref/api/File.html

[KnorpelSenf]

LGTM