From d96ac70e55726839efb7ab61f052e35161dc3d7a Mon Sep 17 00:00:00 2001 From: Martin Bonnin Date: Sat, 29 Nov 2025 16:56:38 +0100 Subject: [PATCH 1/8] Decapitalize Custom, Scalar and String --- README.md | 20 ++++++++++---------- scalars/template-string.md | 14 +++++++------- scalars/template.md | 8 ++++---- 3 files changed, 21 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index a27fc7a..61bb5ec 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,15 @@ -# GraphQL Custom Scalars Specification Contribution Guide +# GraphQL scalars Specification Contribution Guide -Thanks for contributing to GraphQL Scalars. +Thanks for contributing to GraphQL scalars. -The goal of the GraphQL Scalars project is to provide a directory of GraphQL -Custom Scalar specifications, contributed by the community. Contributed +The goal of the GraphQL scalars project is to provide a directory of GraphQL +custom scalar specifications, contributed by the community. Contributed specifications are hosted on a GraphQL Foundation owned domain [scalars.graphql.org](https://scalars.graphql.org), which can be referenced with the built-in `@specifiedBy` [GraphQL directive](https://spec.graphql.org/draft/#sec--specifiedBy). -GraphQL Custom Scalar specifications are language agnostic and thus can be used +GraphQL custom scalar specifications are language-agnostic and thus can be used to document and standardize behavior across different languages. Please ensure that you read the @@ -20,10 +20,10 @@ this project. 1. Copy the `template-string.md` [template](https://github.com/graphql/graphql-scalars/blob/main/scalars/template-string.md) - for Custom Scalars based on the built-in String Scalar, or otherwise use the + for custom scalars based on the built-in String scalar, or otherwise use the `template.md` [template](https://github.com/graphql/graphql-scalars/blob/main/scalars/template.md) - for all other Custom Scalars. Templates are located in the + for all other custom scalars. Templates are located in the [graphql-scalars GitHub repository](https://github.com/graphql/graphql-scalars/tree/main/scalars). 2. Modify your selected template, and save it in the correct place @@ -42,7 +42,7 @@ this project. 4. Run `npm test` to ensure proper formatting before submitting a pull request. 5. [Open a new pull request](https://github.com/graphql/graphql-scalars/pulls) - for each Custom Scalar specification you would like to add. + for each custom scalar specification you would like to add. ### Review process @@ -58,13 +58,13 @@ Specification semantics must not change, as specifications are publicly available reference documents. We will permit small edits which do not change specification semantics, such as typo fixes. -A new version of a Custom Scalar specification should have a new scalar name, +A new version of a custom scalar specification should have a new scalar name, either with a number appended such as `2`, or a different name such as `OffsetDateTime` to differentiate from `DateTime`. ## Licensing -Specifications contributed to the GraphQL Scalars repository are part of the +Specifications contributed to the GraphQL scalars repository are part of the GraphQL Specification Project and are made available by the [Joint Development Foundation](https://www.jointdevelopment.org/). The current [GraphQL Working Group](https://github.com/graphql/graphql-wg) charter, which diff --git a/scalars/template-string.md b/scalars/template-string.md index 15eb915..8b7343c 100644 --- a/scalars/template-string.md +++ b/scalars/template-string.md @@ -1,13 +1,13 @@ -# \ — GraphQL Custom Scalar +# \ — GraphQL custom scalar "Author - \ " "Date - \" This template is meant to be copied and modified. This template is meant for -Scalars which are based on the built-in String Scalar +scalars which are based on the built-in String scalar **License and Copyright** @@ -16,22 +16,22 @@ Copyright © GraphQL contributors. This specification is licensed under # Overview -Provide an overview of what this Scalar does and provide any background +Provide an overview of what this scalar does and provide any background information. # Name -Provide a recommended Scalar name and list alternatives, if available. +Provide a recommended scalar name and list alternatives, if available. # Result spec -Define which Strings can be returned. +Define which string can be returned. -Provide positive and negative examples of String return values. +Provide positive and negative examples of string return values. # Input spec -Define which String values are accepted as input as GraphQL Literal and as JSON +Define which string values are accepted as input as GraphQL Literal and as JSON raw input. Provide positive and negative examples of literal and JSON raw input values. diff --git a/scalars/template.md b/scalars/template.md index 8aa60d1..203c8c9 100644 --- a/scalars/template.md +++ b/scalars/template.md @@ -1,13 +1,13 @@ -# \ — GraphQL Custom Scalar +# \ — GraphQL custom scalar "Author - \ " "Date - \" This template is meant to be copied and modified. This template is meant for -Scalars which are _not_ based on the built-in String Scalar +scalars which are _not_ based on the built-in String scalar **License and Copyright** @@ -16,12 +16,12 @@ Copyright © GraphQL contributors. This specification is licensed under # Overview -Provide an overview of what this Scalar does and provide any background +Provide an overview of what this scalar does and provide any background information. # Name -Provide a recommended Scalar name and list alternatives, if available. +Provide a recommended scalar name and list alternatives, if available. # Result JSON spec From 557e32d891dcda80dd1eb4ad38dad2d8f7988832 Mon Sep 17 00:00:00 2001 From: Martin Bonnin Date: Mon, 1 Dec 2025 09:42:18 +0100 Subject: [PATCH 2/8] Update scalars/template-string.md --- scalars/template-string.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scalars/template-string.md b/scalars/template-string.md index 8b7343c..b9e9bbf 100644 --- a/scalars/template-string.md +++ b/scalars/template-string.md @@ -1,6 +1,6 @@ -# \ — GraphQL custom scalar +# \ — GraphQL Custom Scalar "Author - \ " From 77453192050741ff601709d598cbdc8b8e999e19 Mon Sep 17 00:00:00 2001 From: Martin Bonnin Date: Mon, 1 Dec 2025 09:42:37 +0100 Subject: [PATCH 3/8] Update scalars/template.md --- scalars/template.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scalars/template.md b/scalars/template.md index 203c8c9..dcc27f7 100644 --- a/scalars/template.md +++ b/scalars/template.md @@ -1,6 +1,6 @@ -# \ — GraphQL custom scalar +# \ — GraphQL Custom Scalar "Author - \ " From de0aafd964097ccaa9618c90658a6a4840cd2059 Mon Sep 17 00:00:00 2001 From: Martin Bonnin Date: Mon, 1 Dec 2025 09:42:51 +0100 Subject: [PATCH 4/8] Update scalars/template-string.md --- scalars/template-string.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scalars/template-string.md b/scalars/template-string.md index b9e9bbf..4e56af5 100644 --- a/scalars/template-string.md +++ b/scalars/template-string.md @@ -25,7 +25,7 @@ Provide a recommended scalar name and list alternatives, if available. # Result spec -Define which string can be returned. +Define which strings can be returned. Provide positive and negative examples of string return values. From 1627fd58d3658625d20133f34f2f07713193420f Mon Sep 17 00:00:00 2001 From: Martin Bonnin Date: Mon, 1 Dec 2025 09:43:16 +0100 Subject: [PATCH 5/8] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 61bb5ec..a3bf7a5 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# GraphQL scalars Specification Contribution Guide +# GraphQL Custom Scalars Specification Contribution Guide Thanks for contributing to GraphQL scalars. From bda94dd7e4a602403cbf56f67957692484d20ff1 Mon Sep 17 00:00:00 2001 From: Martin Bonnin Date: Mon, 1 Dec 2025 09:43:30 +0100 Subject: [PATCH 6/8] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a3bf7a5..e1af18f 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # GraphQL Custom Scalars Specification Contribution Guide -Thanks for contributing to GraphQL scalars. +Thanks for contributing to GraphQL Scalars. The goal of the GraphQL scalars project is to provide a directory of GraphQL custom scalar specifications, contributed by the community. Contributed From a806fde98c7ba9c14cee434bdc8c02550f3c872e Mon Sep 17 00:00:00 2001 From: Martin Bonnin Date: Mon, 1 Dec 2025 09:43:46 +0100 Subject: [PATCH 7/8] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index e1af18f..cc34559 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ Thanks for contributing to GraphQL Scalars. -The goal of the GraphQL scalars project is to provide a directory of GraphQL +The goal of the GraphQL Scalars project is to provide a directory of GraphQL custom scalar specifications, contributed by the community. Contributed specifications are hosted on a GraphQL Foundation owned domain [scalars.graphql.org](https://scalars.graphql.org), which can be referenced with From 6eb832b67570537ca4a6094f36420597e94ca2a0 Mon Sep 17 00:00:00 2001 From: Martin Bonnin Date: Mon, 1 Dec 2025 09:44:05 +0100 Subject: [PATCH 8/8] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index cc34559..fd95fc3 100644 --- a/README.md +++ b/README.md @@ -64,7 +64,7 @@ as `OffsetDateTime` to differentiate from `DateTime`. ## Licensing -Specifications contributed to the GraphQL scalars repository are part of the +Specifications contributed to the GraphQL Scalars repository are part of the GraphQL Specification Project and are made available by the [Joint Development Foundation](https://www.jointdevelopment.org/). The current [GraphQL Working Group](https://github.com/graphql/graphql-wg) charter, which