Skip to content

Commit 580d292

Browse files
committed
tighten notes
1 parent c41e64f commit 580d292

File tree

1 file changed

+10
-13
lines changed

1 file changed

+10
-13
lines changed

spec/Section 2 -- Language.md

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1399,7 +1399,11 @@ DirectiveCoordinate :: @ Name
13991399
DirectiveArgumentCoordinate :: @ 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
14051409
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
14291433
a union member; this preserves the uniqueness property of a _schema coordinate_
14301434
as 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

14411438
SchemaCoordinateToken ::
@@ -1446,12 +1443,12 @@ SchemaCoordinateToken ::
14461443
SchemaCoordinatePunctuator :: one of ( ) . : @
14471444

14481445
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}.
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
14551452
lexical form.
14561453

14571454
**Resolving a Schema Coordinate**

0 commit comments

Comments
 (0)