Skip to content

Commit 468d848

Browse files
authored
editorial: move normative clause above example in descriptions (#1173)
1 parent 7eb8983 commit 468d848

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

spec/Section 2 -- Language.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -247,6 +247,11 @@ GraphQL descriptions are provided as Markdown (as specified by
247247
[CommonMark](https://commonmark.org/)). Description strings (often
248248
{BlockString}) occur immediately before the definition they describe.
249249

250+
Descriptions in GraphQL executable documents are purely for documentation
251+
purposes. They MUST NOT affect the execution, validation, or response of a
252+
GraphQL document. It is safe to remove all descriptions and comments from
253+
executable documents without changing their behavior or results.
254+
250255
This is an example of a well-described operation:
251256

252257
```graphql example
@@ -279,11 +284,6 @@ fragment TimeMachineDetails on TimeMachine {
279284
}
280285
```
281286

282-
Descriptions in GraphQL executable documents are purely for documentation
283-
purposes. They MUST NOT affect the execution, validation, or response of a
284-
GraphQL document. It is safe to remove all descriptions and comments from
285-
executable documents without changing their behavior or results.
286-
287287
## Document
288288

289289
Document : Definition+

0 commit comments

Comments
 (0)