How to create example-oriented documentation for an Absinthe GraphQL API?

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.