docusaurus-graphql-plugin
docusaurus-graphql-plugin copied to clipboard
Replace the GitHub example with something else?
Although most of the ideas come from GitHub's documentation, it turns out their APIs and documentation is very much opinionated. They are probably not a good example of a "vanilla" GraphQL API. A few examples are:
- As pointed in #2, each mutation has a dedicated return type that's a wrapper over some other real types. For example
addComment
returns aAddCommentPayload
object. So when documenting a mutation they show the detail of what's returned instead of linking to the object. And the types ending withPayload
are not listed on the objects page.
It's hard to use them as a basic example as the result doesn't look that good. I do think that this plugin should offer options to get a similar result but it would be more advanced. Perhaps we should have a basic example using a simpler API and the advanced example using GitHub's, with the proper configuration.