New comment handling (BREAKING CHANGE)

[cbumstead]

Due to BREAKING CHANGES in the GraphQL spec about how comments are treated means using a number sign to indicate a comment in GraphQL schema files is no longer visible in the metadata that represents that schema. graphql/graphql-js#927 The new recommendation is to use three quotes to indicate a comment block.

NO LONGER SUPPORTED

  # Examples:
  # pl1: playlist(id: "{{summerPlaylist.id}}") @sla(maxResponseTime: "1s")
  # pl2: playlist(id: "{{fallPlaylist.id}}") @ensureMinimum(nItems: 2, inArrays:["pl2.tracks"])
  playlist(id: ID!): Playlist

MUST USE THIS STYLE

  """
  Examples:
  pl1: playlist(id: "{{summerPlaylist.id}}") @sla(maxResponseTime: "1s")
  pl2: playlist(id: "{{fallPlaylist.id}}") @ensureMinimum(nItems: 2, inArrays:["pl2.tracks"])
  """
  playlist(id: ID!): Playlist