Skip to content

Commit 46dcb68

Browse files
committed
Merge branch 'main' of https://github.com/graphql/graphql-spec into graphql-main
# Conflicts: # spec/Section 2 -- Language.md
2 parents a46f76d + 47a6bfd commit 46dcb68

File tree

1 file changed

+14
-12
lines changed

1 file changed

+14
-12
lines changed

spec/Section 2 -- Language.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -306,7 +306,7 @@ mutation {
306306
}
307307
```
308308

309-
**Query Shorthand**
309+
**Query shorthand**
310310

311311
If a document contains only one operation and that operation is a query which
312312
defines no variables and has no directives applied to it then that operation may
@@ -358,8 +358,8 @@ piece of information available to request within a selection set.
358358
Some fields describe complex data or relationships to other data. In order to
359359
further explore this data, a field may itself contain a selection set, allowing
360360
for deeply nested requests. All GraphQL operations must specify their selections
361-
down to leaf fields (fields whose unwrapped type is a scalar or enum) to ensure
362-
an unambiguously shaped response.
361+
down to fields which return scalar values to ensure an unambiguously shaped
362+
response.
363363

364364
For example, this operation selects fields of complex data and relationships
365365
down to scalar values.
@@ -439,7 +439,7 @@ Many arguments can exist for a given field:
439439
}
440440
```
441441

442-
**Arguments are Unordered**
442+
**Arguments are unordered**
443443

444444
Arguments may be provided in any syntactic order and maintain identical semantic
445445
meaning.
@@ -667,11 +667,13 @@ be present and `likers` will not. Conversely when the result is a `Page`,
667667

668668
InlineFragment : ... TypeCondition? Directives? SelectionSet
669669

670-
Fragments can be defined inline within a selection set. This is done to
671-
conditionally include fields based on the concrete type of the object at
672-
runtime. This feature of standard fragment inclusion was demonstrated in the
673-
`query FragmentTyping` example. We could accomplish the same thing using inline
674-
fragments.
670+
Fragments can also be defined inline within a selection set. This is useful for
671+
conditionally including fields based on a type condition or applying a directive
672+
to a selection set.
673+
674+
This feature of standard fragment inclusion was demonstrated in the
675+
`query FragmentTyping` example above. We could accomplish the same thing using
676+
inline fragments.
675677

676678
```graphql example
677679
query inlineFragmentTyping {
@@ -1128,7 +1130,7 @@ curly-braces `{ }`. The values of an object literal may be any input value
11281130
literal or variable (ex. `{ name: "Hello world", score: 1.0 }`). We refer to
11291131
literal representation of input objects as "object literals."
11301132

1131-
**Input Object Fields are Unordered**
1133+
**Input object fields are unordered**
11321134

11331135
Input object fields may be provided in any syntactic order and maintain
11341136
identical semantic meaning.
@@ -1205,7 +1207,7 @@ size `60`:
12051207
}
12061208
```
12071209

1208-
**Variable Use within Fragments**
1210+
**Variable use within Fragments**
12091211

12101212
Variables can be used within fragments. Variables have global scope with a given
12111213
operation, so a variable used within a fragment must be declared in any
@@ -1280,7 +1282,7 @@ As future versions of GraphQL adopt new configurable execution capabilities,
12801282
they may be exposed via directives. GraphQL services and tools may also provide
12811283
any additional _custom directive_ beyond those described here.
12821284

1283-
**Directive Order is Significant**
1285+
**Directive order is significant**
12841286

12851287
Directives may be provided in a specific syntactic order which may have semantic
12861288
interpretation.

0 commit comments

Comments
 (0)