The June 2018 GraphQL spec states the following regarding descriptions (Source): To allow GraphQL service designers to easily publish documentation alongside the capabilities of a GraphQL service, ...