@@ -1399,7 +1399,11 @@ DirectiveCoordinate :: @ Name
1399
1399
DirectiveArgumentCoordinate :: @ Name ( Name : )
1400
1400
1401
1401
:: 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.
1403
1407
1404
1408
:: A _schema element_ can be a named type, a field, an input field, an enum
1405
1409
value, a field argument, a directive, or a directive argument defined within a
@@ -1446,12 +1450,12 @@ SchemaCoordinateToken ::
1446
1450
SchemaCoordinatePunctuator :: one of ( ) . : @
1447
1451
1448
1452
A {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 }.
1453
+ tokens , it is not contained within a { Document }. The source text of a
1454
+ SchemaCoordinate must be a sequence of {SourceCharacter }.
1451
1455
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
1456
+ Unlike other [GraphQL documents ](#sec-Language), {SchemaCoordinate} must not
1457
+ contain {Whitespace} or other {Ignored} grammars within the character sequence.
1458
+ This ensures that every schema coordinates has a single unambiguous and unique
1455
1459
lexical form.
1456
1460
1457
1461
**Resolving a Schema Coordinate**
0 commit comments