Skip to content

Commit

Permalink
Add Names sub-section to Language
Browse files Browse the repository at this point in the history
Address common questions around named things in GraphQL. case-sensitivity, ASCII subset, underscores.

Fixes #33
  • Loading branch information
leebyron committed Jul 7, 2015
1 parent 70ba1d8 commit 5c27ccb
Showing 1 changed file with 15 additions and 0 deletions.
15 changes: 15 additions & 0 deletions Section 2 -- Language.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,21 @@ refer to these requests as documents. A document may contain operations
(queries and mutations are both operations) and fragments, a common unit
of composition allowing for query reuse.

## Names

GraphQL documents are full of named things: operations, fields, arguments,
directives, fragments, and variables. All names follow the same
grammatical form:

Name : /[_A-Za-z][_0-9A-Za-z]*/

Names in GraphQL are case-sensitive. That is to say `name`, `Name`, and `NAME`
all refer to different names. Underscores are significant, which means
`other_name` and `othername` are two different names.

Names in GraphQL are limited to this <acronym>ASCII</acronym> subset of possible
characters to support interoperation with as many other systems as possible.

## Document

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

0 comments on commit 5c27ccb

Please sign in to comment.