Skip to content

Commit 5c27ccb

Browse files
committed
Add Names sub-section to Language
Address common questions around named things in GraphQL. case-sensitivity, ASCII subset, underscores. Fixes #33
1 parent 70ba1d8 commit 5c27ccb

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

Section 2 -- Language.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,21 @@ refer to these requests as documents. A document may contain operations
55
(queries and mutations are both operations) and fragments, a common unit
66
of composition allowing for query reuse.
77

8+
## Names
9+
10+
GraphQL documents are full of named things: operations, fields, arguments,
11+
directives, fragments, and variables. All names follow the same
12+
grammatical form:
13+
14+
Name : /[_A-Za-z][_0-9A-Za-z]*/
15+
16+
Names in GraphQL are case-sensitive. That is to say `name`, `Name`, and `NAME`
17+
all refer to different names. Underscores are significant, which means
18+
`other_name` and `othername` are two different names.
19+
20+
Names in GraphQL are limited to this <acronym>ASCII</acronym> subset of possible
21+
characters to support interoperation with as many other systems as possible.
22+
823
## Document
924

1025
GraphQL documents are only executable by a server if they contain an operation.

0 commit comments

Comments
 (0)