Documentation for GraphQL

Should we be writing documentation for resources added to GraphQL?

The schema is also self-documenting, so I think we better take care of writing a clear schema, and exposing it properly.

Right now we only have GraphiQL that allows querying the schema, should we look out for something better?