Apollo-server: Federation: Syntax error when adding a description to an extended type

[JacksonKearl]

The federated schema

"""
A description of this extended type.
"""
extend type User @key(fields: "id") {
  "The unique ID of the user."
  id: ID! @external
  "The URL of the user's avatar."
  avatar: String
}

Results in GraphQLError: Syntax Error: Unexpected Name "extend" at parse. This does not happen if the description is removed.

(Thanks to @mandiwise for finding this, over in #2808)

[JacksonKearl]

@jbaxleyiii Do you think extended types should be able to even have descriptions? It might make the most sense to prohibit/ignore descriptions on @external fields and extended types. What do you think?

[JacksonKearl]

Turns out this is per-spec, only type definitions may have a description, type extensions may not. https://graphql.github.io/graphql-spec/June2018/#sec-Object-Extensions

[mandiwise]

Good to know, thanks for the insight.