I’m creating a GraphQL API with Absinthe. Having /graphiql
will let our users explore the data types and operations available, but I’d really like add some example-based documentation also. Like, “here’s the query to get a blog post and all its moderator-approved comments.”
Ideally, these examples would be like doctests - provably correct. Does anybody have suggested approaches for that? bureaucrat | Hex + controller tests are my best idea at the moment.