feedback and reorder

Author: leebyron

LICENSE.md

@@ -1,7 +1,8 @@
-## Copyright and Licensing
+# Appendix: Copyright and Licensing
 
 The GraphQL Specification Project is made available by the
-[Joint Development Foundation](https://www.jointdevelopment.org/). The current
+[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

scripts/update-appendix-c.mjs renamed to scripts/update-appendix-specified-definitions.mjs

@@ -1,7 +1,7 @@
 import { writeFile } from 'node:fs/promises';
 import { printIntrospectionSchema, buildSchema, specifiedScalarTypes, printType } from 'graphql';
 
-const FILE = './spec/Appendix C -- Specified Definitions.md';
+const FILE = './spec/Appendix D -- Specified Definitions.md';
 function printSpecifiedScalars() {
   return specifiedScalarTypes
     .map((type) => printType(type))

spec/Appendix D -- Conformance & Licensing.md renamed to spec/Appendix A -- Conformance.md

@@ -1,6 +1,4 @@
-# D. Appendix: Conformance & Licensing
-
-## Conformance
+# A. Appendix: Conformance
 
 A conforming implementation of GraphQL must fulfill all normative requirements.
 Conformance requirements are described in this document via both descriptive
@@ -60,5 +58,3 @@ questions that arise during implementation. Notes are either introduced
 explicitly in prose (e.g. "Note: ") or are set apart in a note block, like this:
 
 Note: This is an example of a non-normative note.
-
-## [LICENSE](../LICENSE.md)

spec/Appendix A -- Notation Conventions.md renamed to spec/Appendix B -- Notation Conventions.md

@@ -1,4 +1,4 @@
-# A. Appendix: Notation Conventions
+# B. Appendix: Notation Conventions
 
 This specification document contains a number of notation conventions used to
 describe technical concepts such as language grammar and semantics as well as

spec/Appendix B -- Grammar Summary.md renamed to spec/Appendix C -- Grammar Summary.md

@@ -1,4 +1,4 @@
-# B. Appendix: Grammar Summary
+# C. Appendix: Grammar Summary
 
 ## Source Text
 

spec/Appendix C -- Specified Definitions.md renamed to spec/Appendix D -- Specified Definitions.md

@@ -1,4 +1,4 @@
-# C. Appendix: Type System Definitions
+# D. Appendix: Type System Definitions
 
 This appendix lists the specified type system definitions.
 

spec/GraphQL.md

@@ -8,23 +8,26 @@ This is the specification for GraphQL, a query language and execution engine for
 describing and performing the capabilities and requirements of data models for
 client-server applications.
 
+A conforming implementation of GraphQL must fulfill all normative requirements
+described in this specification (see [Conformance](#sec-Appendix-Conformance)).
+The GraphQL specification is provided under the OWFa 1.0 license (see
+[Licensing](#sec-Appendix-Copyright-and-Licensing)).
+
 GraphQL was originally created in 2012 and the development of this open standard
-started in 2015. This specification was licensed under OWFa 1.0 in 2017 (see
-[Licensing](#sec-Copyright-and-Licensing)). The
-[GraphQL Foundation](https://graphql.org/foundation/) was formed in 2019 as a
-neutral focal point for organizations who support the GraphQL ecosystem, and the
-[GraphQL Specification Project](https://graphql.org/community/) was established
-also in 2019 as the Joint Development Foundation Projects, LLC, GraphQL Series.
-If your organization benefits from GraphQL, please consider
-[becoming a member](https://graphql.org/foundation/join/#graphql-foundation) and
-helping us to sustain the activities that support the health of our neutral
-ecosystem.
+started in 2015. It is a deliverable of the
+[GraphQL Specification Project](https://graphql.org/community/), established in
+2019 with the [Joint Development Foundation](https://www.jointdevelopment.org/).
+
+The [GraphQL Foundation](https://graphql.org/foundation/) was formed in 2019 as
+a neutral focal point for organizations who support development of the GraphQL
+ecosystem. If your organization benefits from GraphQL, please consider
+[becoming a member](https://graphql.org/foundation/join/#graphql-foundation).
 
 This specification is developed on GitHub at
 [graphql/graphql-spec](https://github.com/graphql/graphql-spec/). Contributions
 are managed by the
 [GraphQL Working Group](https://github.com/graphql/graphql-wg), hosted by the
-[GraphQL TSC](https://github.com/graphql/graphql-wg/blob/main/GraphQL-TSC.md).
+[GraphQL Technical Steering Committee](https://github.com/graphql/graphql-wg/blob/main/GraphQL-TSC.md).
 To learn more see the
 [contribution guide](https://github.com/graphql/graphql-spec/blob/main/CONTRIBUTING.md).
 
@@ -49,10 +52,12 @@ working draft release can be found at
 
 # [Response](Section%207%20--%20Response.md)
 
-# [Appendix: Notation Conventions](Appendix%20A%20--%20Notation%20Conventions.md)
+# [Appendix: Conformance](Appendix%20A%20--%20Conformance.md)
+
+# [Appendix: Notation Conventions](Appendix%20B%20--%20Notation%20Conventions.md)
 
-# [Appendix: Grammar Summary](Appendix%20B%20--%20Grammar%20Summary.md)
+# [Appendix: Grammar Summary](Appendix%20C%20--%20Grammar%20Summary.md)
 
-# [Appendix: Specified Definitions](Appendix%20C%20--%20Specified%20Definitions.md)
+# [Appendix: Specified Definitions](Appendix%20D%20--%20Specified%20Definitions.md)
 
-# [Appendix: Conformance & Licensing](Appendix%20D%20--%20Conformance%20&%20Licensing.md)
+# [Appendix: Licensing](../LICENSE.md)