Currently graphql-java does not appear to support the GraphQL spec around comments. See http://spec.graphql.org/June2018/#sec-Comments This would be a useful documentation addition.