Produce automated documentation for GraphQL "language"

[waxlamp]

i.e. find some software that can read an annotated GraphQL spec and generate documentation for it.

[waxlamp]

GraphQL supports directly documenting types, queries, etc., along with their fields, by simply putting string or block string literals before each item:

"""
Type documentation goes here.
"""
type Foobar {
  .
  .
  .
}

The Python GraphQL engine we're using doesn't support parsing these just yet, but there's a PR on a fork: graphql-python/graphql-core#222. If and when this lands we can take care of this issue.