Merge branch 'main' of https://github.com/graphql/graphql-spec into graphql-main

rivantsov · rivantsov · commit 46dcb6844357 · 2022-06-29T19:58:42.000-07:00
# Conflicts:
#	spec/Section 2 -- Language.md
diff --git a/spec/Section 2 -- Language.md b/spec/Section 2 -- Language.md
@@ -306,7 +306,7 @@ mutation {
 }
 ```
 
-**Query Shorthand**
+**Query shorthand**
 
 If a document contains only one operation and that operation is a query which
 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.
 Some fields describe complex data or relationships to other data. In order to
 further explore this data, a field may itself contain a selection set, allowing
 for deeply nested requests. All GraphQL operations must specify their selections
-down to leaf fields (fields whose unwrapped type is a scalar or enum) to ensure
-an unambiguously shaped response.
+down to fields which return scalar values to ensure an unambiguously shaped
+response.
 
 For example, this operation selects fields of complex data and relationships
 down to scalar values.
@@ -439,7 +439,7 @@ Many arguments can exist for a given field:
 }
 ```
 
-**Arguments are Unordered**
+**Arguments are unordered**
 
 Arguments may be provided in any syntactic order and maintain identical semantic
 meaning.
@@ -667,11 +667,13 @@ be present and `likers` will not. Conversely when the result is a `Page`,
 
 InlineFragment : ... TypeCondition? Directives? SelectionSet
 
-Fragments can be defined inline within a selection set. This is done to
-conditionally include fields based on the concrete type of the object at
-runtime. This feature of standard fragment inclusion was demonstrated in the
-`query FragmentTyping` example. We could accomplish the same thing using inline
-fragments.
+Fragments can also be defined inline within a selection set. This is useful for
+conditionally including fields based on a type condition or applying a directive
+to a selection set.
+
+This feature of standard fragment inclusion was demonstrated in the
+`query FragmentTyping` example above. We could accomplish the same thing using
+inline fragments.
 
 ```graphql example
 query inlineFragmentTyping {
@@ -1128,7 +1130,7 @@ curly-braces `{ }`. The values of an object literal may be any input value
 literal or variable (ex. `{ name: "Hello world", score: 1.0 }`). We refer to
 literal representation of input objects as "object literals."
 
-**Input Object Fields are Unordered**
+**Input object fields are unordered**
 
 Input object fields may be provided in any syntactic order and maintain
 identical semantic meaning.
@@ -1205,7 +1207,7 @@ size `60`:
 }
 ```
 
-**Variable Use within Fragments**
+**Variable use within Fragments**
 
 Variables can be used within fragments. Variables have global scope with a given
 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,
 they may be exposed via directives. GraphQL services and tools may also provide
 any additional _custom directive_ beyond those described here.
 
-**Directive Order is Significant**
+**Directive order is significant**
 
 Directives may be provided in a specific syntactic order which may have semantic
 interpretation.
