WIP: Resolve "Automate generation of graphql documentation"
What does this MR do?
Automates the generation of graphql documentation.
Blocker:
per process here: https://docs.gitlab.com/ee/development/documentation/site_architecture/release_process.html
https://gitlab.com/gitlab-org/gitlab-docs/-/blob/master/Rakefile
It looks as though prod release is built from a branches of few repos so docs needs to be checked in with current architecture.
related: gitlab-foss#18106 (moved)
TODO:
-
Remove graphql documentation files -
doc/api/graphql/reference/index.md. -
Machine readable
-
-
Add those files to gitignore -
Ensure docs are output/viewable in review app -
Change documentation here: https://docs.gitlab.com/ee/development/rake_tasks.html#update-graphql-documentation-and-schema-definitions -
Change documentation here: https://docs.gitlab.com/ee/development/api_graphql_styleguide.html#documentation-and-schema -
Consider if the prepare stage makes the most sense -
Include link to final docs from review app in issue description
Proof that it works:
Edited by Allison Browne