feat(docs): add astro-graphql-plugin to the documentation

[AlexLakatos]

Add astro-graphql-plugin plugin that automatically generates GraphQL API docs on every build.

Changes proposed in this pull request

• port old graphql-plugin to astro and add it to the docs
• fix implementedBy link paths
• remove doc generation step from CI

Context

Closes #1815

Checklist

• Related issues linked using fixes #number
• Tests added/updated
• Documentation added
• Make sure that all checks pass
• Postman collection updated

[netlify]

✅ Deploy Preview for brilliant-pasca-3e80ec ready!

Name	Link
🔨 Latest commit	5b03944
🔍 Latest deploy log	https://app.netlify.com/sites/brilliant-pasca-3e80ec/deploys/65059f5d1288340008bd571b
😎 Deploy Preview	https://deploy-preview-1814--brilliant-pasca-3e80ec.netlify.app/
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[AlexLakatos]

@huijing: of course I left a bug in there for you 😅 . The sidebar gets expanded and highlighted twice, because both the Backend API and the Auth API have the same menu items. I'm pretty sure that's not a bug with the plugin, and it's an Astro thing though.

[AlexLakatos]

@huijing Ignore that last comment, turns out PEBCAK, and it was my fault. I fixed it in 7723574

[huijing]

Ran locally and LGTM.
But would like @mkurapov and @sabineschaller to chime in.
Also, how does this work, do the markdown files get generated when the build runs or? How do people update the docs when the schema changes?

[sabineschaller]

@mkurapov why is there no preview for this?

[mkurapov]

@sabineschaller from the Netlify logs:

10:36:59 PM: No changes detected in base directory. Returning early from build.

I removed the cache and re-built, the preview is there now

[sabineschaller]

from the logs:

10:36:59 PM: No changes detected in base directory. Returning early from build.

I removed the cache and re-built, the preview is there now

@mkurapov Oh, so the splitting of the file doesn't happen locally but on build?

[mkurapov]

Just checked on rafiki.dev, all looks 👌 thanks @AlexLakatos & @huijing !

All wanted to mention is we can remove packages/documentation/src/schema-dumps folder now, but NABD

[AlexLakatos]

@mkurapov missed those, sorry. Here's a PR for it: #1888