@@ -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
@@ -1429,13 +1433,6 @@ identified by a {TypeCoordinate}. There is no schema coordinate which indicates
1429
1433
a union member; this preserves the uniqueness property of a _schema coordinate_
1430
1434
as stated above.
1431
1435
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
-
1439
1436
**Parsing a Schema Coordinate**
1440
1437
1441
1438
SchemaCoordinateToken ::
@@ -1446,12 +1443,12 @@ SchemaCoordinateToken ::
1446
1443
SchemaCoordinatePunctuator :: one of ( ) . : @
1447
1444
1448
1445
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 }.
1446
+ tokens , it is not contained within a { Document }. The source text of a
1447
+ SchemaCoordinate must be a sequence of {SourceCharacter }.
1451
1448
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
1455
1452
lexical form.
1456
1453
1457
1454
**Resolving a Schema Coordinate**
0 commit comments