@@ -1399,7 +1399,11 @@ DirectiveCoordinate :: @ Name
13991399DirectiveArgumentCoordinate :: @ Name ( Name : )
14001400
14011401:: A _schema coordinate_ is a human readable string that uniquely identifies a
1402- _schema element_ within a GraphQL Schema .
1402+ _schema element_ within a GraphQL Schema , intended to be used by tools to
1403+ reference types , fields , and other _schema element_ . Examples include :
1404+ references within documentation to refer to types and fields in a schema , a
1405+ lookup key that can be used in logging tools to track how often particular
1406+ fields are queried in production.
14031407
14041408:: A _schema element_ can be a named type, a field, an input field, an enum
14051409value, a field argument, a directive, or a directive argument defined within a
@@ -1429,13 +1433,6 @@ identified by a {TypeCoordinate}. There is no schema coordinate which indicates
14291433a union member; this preserves the uniqueness property of a _schema coordinate_
14301434as stated above.
14311435
1432- Note: A {SchemaCoordinate} is not a definition within a GraphQL {Document }, but
1433- a separate standalone grammar , intended to be used by tools to reference types ,
1434- fields , and other _schema element_ . Examples include : references within
1435- documentation to refer to types and fields in a schema , a lookup key that can be
1436- used in logging tools to track how often particular fields are queried in
1437- production.
1438-
14391436**Parsing a Schema Coordinate**
14401437
14411438SchemaCoordinateToken ::
@@ -1446,12 +1443,12 @@ SchemaCoordinateToken ::
14461443SchemaCoordinatePunctuator :: one of ( ) . : @
14471444
14481445A {SchemaCoordinate} is a self -contained grammar with its own set of lexical
1449- tokens . The source text of a SchemaCoordinate must be a sequence of
1450- {SourceCharacter }.
1446+ tokens , it is not contained within a { Document }. The source text of a
1447+ SchemaCoordinate must be a sequence of {SourceCharacter }.
14511448
1452- Unlike [GraphQL documents ](#sec-Language), {SchemaCoordinate} must not contain
1453- {Whitespace} or other {Ignored} grammars within the character sequence. This
1454- ensures that every schema coordinates has a single unambiguous and unique
1449+ Unlike other [GraphQL documents ](#sec-Language), {SchemaCoordinate} must not
1450+ contain {Whitespace} or other {Ignored} grammars within the character sequence.
1451+ This ensures that every schema coordinates has a single unambiguous and unique
14551452lexical form.
14561453
14571454**Resolving a Schema Coordinate**
0 commit comments