From 6d43fa85c0c0f98fc7467e35a631446dcba87624 Mon Sep 17 00:00:00 2001 From: Lee Byron Date: Tue, 1 Jul 2025 21:54:21 -0700 Subject: [PATCH] editorial: move normative clause above example in descriptions --- spec/Section 2 -- Language.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/spec/Section 2 -- Language.md b/spec/Section 2 -- Language.md index 86efe1581..ab5a2542d 100644 --- a/spec/Section 2 -- Language.md +++ b/spec/Section 2 -- Language.md @@ -247,6 +247,11 @@ GraphQL descriptions are provided as Markdown (as specified by [CommonMark](https://commonmark.org/)). Description strings (often {BlockString}) occur immediately before the definition they describe. +Descriptions in GraphQL executable documents are purely for documentation +purposes. They MUST NOT affect the execution, validation, or response of a +GraphQL document. It is safe to remove all descriptions and comments from +executable documents without changing their behavior or results. + This is an example of a well-described operation: ```graphql example @@ -279,11 +284,6 @@ fragment TimeMachineDetails on TimeMachine { } ``` -Descriptions in GraphQL executable documents are purely for documentation -purposes. They MUST NOT affect the execution, validation, or response of a -GraphQL document. It is safe to remove all descriptions and comments from -executable documents without changing their behavior or results. - ## Document Document : Definition+