Schema element descriptions can be set through comments

[ir-regular]

Reason for change:

GraphQL schema shorthand parsing currently doesn't allow for adding descriptions to the type system.

Solution description:

Following the Javascript implementations, comment blocks immediately preceding a definition will be treated as a description.

Some examples:

# This is a description of MyType type
type FriendlyType {
  # This is a field description
  friendlyField: String
}

# This is a floating comment, and is therefore not treated as a description of UnfriendlyType

type UnfriendlyType {
  unfriendlyField: String # not a description, just an aside
}

[coveralls]

Coverage decreased (-0.05%) to 92.988% when pulling 060dc51 on jane-olszewska:schema-description-in-comments into c18cd16 on webonyx:master.

[coveralls]

Coverage increased (+0.03%) to 93.064% when pulling 008fd20 on jane-olszewska:schema-description-in-comments into c18cd16 on webonyx:master.

[vladar]

Awesome! Thanks.

[Torsten85]

Am I missing something or do comments disappear when calling AST::fromArray? Calling AST::toArray correctly writes the comments in the returned array.

[vladar]

Looks like it's the same as #201

[Torsten85]

You are right! I'll keep an eye on that issue. Thank you!