@@ -306,7 +306,7 @@ mutation {
306
306
}
307
307
```
308
308
309
- ** Query Shorthand **
309
+ ** Query shorthand **
310
310
311
311
If a document contains only one operation and that operation is a query which
312
312
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.
358
358
Some fields describe complex data or relationships to other data. In order to
359
359
further explore this data, a field may itself contain a selection set, allowing
360
360
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.
363
363
364
364
For example, this operation selects fields of complex data and relationships
365
365
down to scalar values.
@@ -439,7 +439,7 @@ Many arguments can exist for a given field:
439
439
}
440
440
```
441
441
442
- ** Arguments are Unordered **
442
+ ** Arguments are unordered **
443
443
444
444
Arguments may be provided in any syntactic order and maintain identical semantic
445
445
meaning.
@@ -667,11 +667,13 @@ be present and `likers` will not. Conversely when the result is a `Page`,
667
667
668
668
InlineFragment : ... TypeCondition? Directives? SelectionSet
669
669
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.
675
677
676
678
``` graphql example
677
679
query inlineFragmentTyping {
@@ -1128,7 +1130,7 @@ curly-braces `{ }`. The values of an object literal may be any input value
1128
1130
literal or variable (ex. ` { name: "Hello world", score: 1.0 } ` ). We refer to
1129
1131
literal representation of input objects as "object literals."
1130
1132
1131
- ** Input Object Fields are Unordered **
1133
+ ** Input object fields are unordered **
1132
1134
1133
1135
Input object fields may be provided in any syntactic order and maintain
1134
1136
identical semantic meaning.
@@ -1205,7 +1207,7 @@ size `60`:
1205
1207
}
1206
1208
```
1207
1209
1208
- ** Variable Use within Fragments**
1210
+ ** Variable use within Fragments**
1209
1211
1210
1212
Variables can be used within fragments. Variables have global scope with a given
1211
1213
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,
1280
1282
they may be exposed via directives. GraphQL services and tools may also provide
1281
1283
any additional _ custom directive_ beyond those described here.
1282
1284
1283
- ** Directive Order is Significant **
1285
+ ** Directive order is significant **
1284
1286
1285
1287
Directives may be provided in a specific syntactic order which may have semantic
1286
1288
interpretation.
0 commit comments