Merge branch 'main' into fragment-args-2024-amendments

Author: JoviDeCroock

LICENSE.md

@@ -0,0 +1,37 @@
+# Appendix: Copyright and Licensing
+
+The GraphQL Specification Project is made available by the
+[Joint Development Foundation](https://www.jointdevelopment.org/) Projects, LLC,
+GraphQL Series. The current
+[Working Group](https://github.com/graphql/graphql-wg) charter, which includes
+the IP policy governing all working group deliverables (including
+specifications, source code, and datasets) may be found at
+[https://technical-charter.graphql.org](https://technical-charter.graphql.org).
+
+**Copyright Notice**
+
+Copyright © 2015-2018, Facebook, Inc.
+
+Copyright © 2019-present, GraphQL contributors
+
+THESE MATERIALS ARE PROVIDED “AS IS”. The parties expressly disclaim any
+warranties (express, implied, or otherwise), including implied warranties of
+merchantability, non-infringement, fitness for a particular purpose, or title,
+related to the materials. The entire risk as to implementing or otherwise using
+the materials is assumed by the implementer and user. IN NO EVENT WILL THE
+PARTIES BE LIABLE TO ANY OTHER PARTY FOR LOST PROFITS OR ANY FORM OF INDIRECT,
+SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER FROM ANY CAUSES
+OF ACTION OF ANY KIND WITH RESPECT TO THIS DELIVERABLE OR ITS GOVERNING
+AGREEMENT, WHETHER BASED ON BREACH OF CONTRACT, TORT (INCLUDING NEGLIGENCE), OR
+OTHERWISE, AND WHETHER OR NOT THE OTHER MEMBER HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+**Licensing**
+
+The licenses for the GraphQL Specification Project are:
+
+| Deliverable    | License                                                                                                                                                            |
+| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Specifications | [Open Web Foundation Agreement 1.0 (Patent and Copyright Grants)](https://www.openwebfoundation.org/the-agreements/the-owf-1-0-agreements-granted-claims/owfa-1-0) |
+| Source code    | [MIT License](https://opensource.org/licenses/MIT)                                                                                                                 |
+| Data sets      | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/)                                                                                                      |

STYLE_GUIDE.md

@@ -92,7 +92,7 @@ Definition paragraphs start with `::` and add the matching italicized term to
 the [specification index](https://spec.graphql.org/draft/#index), making it easy
 to reference them.
 
-## Tone of voice
+## Tone of Voice
 
 The GraphQL specification is a reference document and should use neutral and
 descriptive tone of voice.
@@ -104,3 +104,35 @@ The present tense is usually clearer and shorter:
 ✅ Present: The client then sends a request to the server.
 
 ❌ Future: The client will then send a request to the server.
+
+**Write in the third person**
+
+The specification should avoid the first person (“we,” “our”) and instead use
+the third person or passive constructions when necessary. For example:
+
+✅ “The server validates the request against the schema.”
+
+❌ “We validate the request against the schema.”
+
+**Use RFC 2119 keywords**
+
+The specification should use the normative keywords defined in
+[RFC 2119](https://www.rfc-editor.org/rfc/rfc2119) (**MUST**, **MUST NOT**,
+**SHOULD**, **SHOULD NOT**, **MAY**). However, in the context of a sentence
+these words should be lower-cased (e.g., “must,” “should,” “may”) in context of
+a sentence. This avoids unnecessary visual emphasis while preserving normative
+meaning.
+
+✅ “A query must contain a single root operation type.”
+
+❌ “A query MUST contain a single root operation type.”
+
+**Avoid unnecessary hyphenation**
+
+Only use hypenated compound words when either commonly used elsewhere in english
+or technical writing. Otherwise prefer separate words or a non-hyphenated
+compound word, whichever is most commonly accepted.
+
+✅ User defined shorthand words are separated by whitespace
+
+❌ User-defined short-hand words are separated by white-space

changelogs/September2025.md

@@ -21,6 +21,8 @@ words:
   - tatooine
   - zuck
   - zuckerberg
+  - brontie
+  - oneOf
 # Forbid Alternative spellings
 flagWords:
   - implementor

cspell.yml

@@ -14,7 +14,7 @@
   },
   "scripts": {
     "test": "npm run test:spelling && npm run test:format && npm run test:build",
-    "test:spelling": "cspell \"spec/**/*.md\" README.md",
+    "test:spelling": "cspell \"spec/**/*.md\" README.md LICENSE.md",
     "format": "prettier --write \"**/*.{md,yml,yaml,json}\"",
     "test:format": "prettier --check \"**/*.{md,yml,yaml,json}\" || npm run suggest:format",
     "test:algorithm-format": "node .github/algorithm-format-check.mjs",