Skip to content

Commit 1a71923

Browse files
committed
tighten notes
1 parent c41e64f commit 1a71923

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

spec/Section 2 -- Language.md

Lines changed: 10 additions & 6 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
@@ -1446,12 +1450,12 @@ SchemaCoordinateToken ::
14461450
SchemaCoordinatePunctuator :: one of ( ) . : @
14471451

14481452
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}.
14511455

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
14551459
lexical form.
14561460

14571461
**Resolving a Schema Coordinate**

0 commit comments

Comments
 (0)