feat: add OpenAPI v3 visualisation to docs

[ndom91]

☕️ Reasoning

• Add visualisation for our OpenAPI docs
  • Somethign like this one
  • See our preview here

🧢 Changes

• Add scripts/generate-docs.mjs script to fetch our swagger definition JSON and convert it from v2 to v3, using Swagger's first party conversion web service. Then, write that v3 swagger json to disk and pass it as input to the fumadocs fn which generates the mdx files that get displayed in the end.
  • This explicitly adds a dependency on the OpenAPI Convertor web service being up for our docs to be built properly.. Some ideas to make us more resilient to this:
    • Commit a copy of the built api reference mdx files now, and the script just overwrites those on build with newer versions, so that there's always at least something to fall back to; Comes with the risk of potentially shipping out-of-date/broken reference though :/
    • Do the conversion ourselves in a GHA via the container image they offer
• Point the "Releases" menu item to github.com/gitbutlerapp/gitbutler/releases instead of attempting to maintain two separate lists.
  • Remove all releases.mdx related code

📸 Screenshots

First Load:

OpenAPI Section:

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
gitbutler-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 29, 2024 0:55am

[github-actions]

Broken Link Checker

1 broken links found. Links organised below by source page, or page where they were found.

1) /api-reference

Target Link	Link Text	Reason
https://github.com/gitbutlerapp/gitbutler-docs/blob/main/content/docs/api-reference/index.mdx	"Edit on GitHub"	HTTP_404

[ndom91]

Can ignore the broken link checker for now, that file is newly added in this PR, therefore the autogenerated link to "edit this page on origin/main" obviously 404's until this PR is merged.