Updated the spec URL for GraphQL custom scalars (#8866)

glen-84 · web-flow · commit 7faac2e8f95a · 2025-11-04T12:47:30.000+02:00
diff --git a/dictionary.txt b/dictionary.txt
@@ -5,6 +5,7 @@ accessibilities
 agrc
 Alderaan
 Andi
+andimarek
 ASPDEPR004
 ASPDEPR008
 aspnetcore
diff --git a/src/HotChocolate/Core/src/Types/Types/Scalars/DateTimeType.cs b/src/HotChocolate/Core/src/Types/Types/Scalars/DateTimeType.cs
@@ -9,14 +9,13 @@ namespace HotChocolate.Types;
 /// <summary>
 /// This GraphQL Scalar represents an exact point in time.
 /// This point in time is specified by having an offset to UTC and does not use time zone.
-///
-/// https://www.graphql-scalars.com/date-time/
 /// </summary>
+/// <seealso href="https://scalars.graphql.org/andimarek/date-time.html">Specification</seealso>
 public class DateTimeType : ScalarType<DateTimeOffset, StringValueNode>
 {
     private const string UtcFormat = "yyyy-MM-ddTHH\\:mm\\:ss.fffZ";
     private const string LocalFormat = "yyyy-MM-ddTHH\\:mm\\:ss.fffzzz";
-    private const string SpecifiedByUri = "https://www.graphql-scalars.com/date-time";
+    private const string SpecifiedByUri = "https://scalars.graphql.org/andimarek/date-time.html";
 
     private static readonly Regex s_dateTimeScalarRegex = new(
         @"^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,7})?(Z|[+-][0-9]{2}:[0-9]{2})$",
@@ -196,7 +195,7 @@ private bool TryDeserializeFromString(
         }
 
         // No "Unknown Local Offset Convention".
-        // https://www.graphql-scalars.com/date-time/#no-unknown-local-offset-convention
+        // https://scalars.graphql.org/andimarek/date-time.html#sec-Overview.No-Unknown-Local-Offset-Convention-
         if (serialized.EndsWith("-00:00"))
         {
             value = null;
diff --git a/src/HotChocolate/Core/test/Execution.Tests/__snapshots__/IntrospectionTests.Query_Specified_By.snap b/src/HotChocolate/Core/test/Execution.Tests/__snapshots__/IntrospectionTests.Query_Specified_By.snap
@@ -1,7 +1,7 @@
 {
   "data": {
     "__type": {
-      "specifiedByURL": "https://www.graphql-scalars.com/date-time"
+      "specifiedByURL": "https://scalars.graphql.org/andimarek/date-time.html"
     }
   }
 }
diff --git a/src/HotChocolate/Core/test/Types.Tests/Configuration/__snapshots__/TypeDiscoveryTests.InferDateTime.snap b/src/HotChocolate/Core/test/Types.Tests/Configuration/__snapshots__/TypeDiscoveryTests.InferDateTime.snap
@@ -11,4 +11,4 @@ type QueryWithDateTime {
 directive @specifiedBy("The specifiedBy URL points to a human-readable specification. This field will only read a result for scalar types." url: String!) on SCALAR
 
 "The `DateTime` scalar represents an ISO-8601 compliant date time type."
-scalar DateTime @specifiedBy(url: "https:\/\/www.graphql-scalars.com\/date-time")
+scalar DateTime @specifiedBy(url: "https:\/\/scalars.graphql.org\/andimarek\/date-time.html")
diff --git a/src/HotChocolate/Core/test/Types.Tests/Configuration/__snapshots__/TypeDiscoveryTests.InferDateTimeFromModel.snap b/src/HotChocolate/Core/test/Types.Tests/Configuration/__snapshots__/TypeDiscoveryTests.InferDateTimeFromModel.snap
@@ -52,4 +52,4 @@ directive @specifiedBy("The specifiedBy URL points to a human-readable specifica
 scalar Date
 
 "The `DateTime` scalar represents an ISO-8601 compliant date time type."
-scalar DateTime @specifiedBy(url: "https:\/\/www.graphql-scalars.com\/date-time")
+scalar DateTime @specifiedBy(url: "https:\/\/scalars.graphql.org\/andimarek\/date-time.html")
diff --git a/src/HotChocolate/Core/test/Types.Tests/Configuration/__snapshots__/TypeDiscoveryTests.TypeDiscovery_Should_InferStructs.snap b/src/HotChocolate/Core/test/Types.Tests/Configuration/__snapshots__/TypeDiscoveryTests.TypeDiscovery_Should_InferStructs.snap
@@ -22,6 +22,6 @@ type QueryTypeWithStruct {
 directive @specifiedBy("The specifiedBy URL points to a human-readable specification. This field will only read a result for scalar types." url: String!) on SCALAR
 
 "The `DateTime` scalar represents an ISO-8601 compliant date time type."
-scalar DateTime @specifiedBy(url: "https:\/\/www.graphql-scalars.com\/date-time")
+scalar DateTime @specifiedBy(url: "https:\/\/scalars.graphql.org\/andimarek\/date-time.html")
 
 scalar UUID @specifiedBy(url: "https:\/\/tools.ietf.org\/html\/rfc4122")
diff --git a/src/HotChocolate/Core/test/Types.Tests/Types/Directives/SpecifiedByDirectiveTypeTests.cs b/src/HotChocolate/Core/test/Types.Tests/Types/Directives/SpecifiedByDirectiveTypeTests.cs
@@ -58,7 +58,7 @@ type Query1 {
                     directive @specifiedBy("The specifiedBy URL points to a human-readable specification. This field will only read a result for scalar types." url: String!) on SCALAR
 
                     "The `DateTime` scalar represents an ISO-8601 compliant date time type."
-                    scalar DateTime @specifiedBy(url: "https:\/\/www.graphql-scalars.com\/date-time")
+                    scalar DateTime @specifiedBy(url: "https:\/\/scalars.graphql.org\/andimarek\/date-time.html")
                     """)
                 .UseField(next => next)
                 .BuildSchemaAsync();
diff --git a/src/HotChocolate/Core/test/Types.Tests/Types/Directives/__snapshots__/SpecifiedByDirectiveTypeTests.EnsureSpecifiedByDirectiveExistsInSdl.graphql b/src/HotChocolate/Core/test/Types.Tests/Types/Directives/__snapshots__/SpecifiedByDirectiveTypeTests.EnsureSpecifiedByDirectiveExistsInSdl.graphql
@@ -10,4 +10,4 @@ type Query1 {
 directive @specifiedBy("The specifiedBy URL points to a human-readable specification. This field will only read a result for scalar types." url: String!) on SCALAR
 
 "The `DateTime` scalar represents an ISO-8601 compliant date time type."
-scalar DateTime @specifiedBy(url: "https:\/\/www.graphql-scalars.com\/date-time")
+scalar DateTime @specifiedBy(url: "https:\/\/scalars.graphql.org\/andimarek\/date-time.html")
diff --git a/src/HotChocolate/Core/test/Types.Tests/Types/Scalars/DateTimeTypeTests.cs b/src/HotChocolate/Core/test/Types.Tests/Types/Scalars/DateTimeTypeTests.cs
@@ -432,7 +432,7 @@ public static TheoryData<string, DateTimeOffset> ValidDateTimeScalarStrings()
     {
         return new TheoryData<string, DateTimeOffset>
         {
-            // https://www.graphql-scalars.com/date-time/#test-cases (valid strings)
+            // https://scalars.graphql.org/andimarek/date-time.html#sec-Overview.Examples (valid examples)
             {
                 // A DateTime with UTC offset (+00:00).
                 "2011-08-30T13:22:53.108Z",
@@ -476,7 +476,7 @@ public static TheoryData<string> InvalidDateTimeScalarStrings()
     {
         return
         [
-            // https://www.graphql-scalars.com/date-time/#test-cases (invalid strings)
+            // https://scalars.graphql.org/andimarek/date-time.html#sec-Overview.Examples (invalid examples)
             // The minutes of the offset are missing.
             "2011-08-30T13:22:53.108-03",
             // Too many digits for fractions of a second. Exactly three expected.
diff --git a/src/HotChocolate/Core/test/Types.Tests/__snapshots__/CodeFirstTests.Change_DefaultBinding_For_DateTime.snap b/src/HotChocolate/Core/test/Types.Tests/__snapshots__/CodeFirstTests.Change_DefaultBinding_For_DateTime.snap
@@ -18,4 +18,4 @@ directive @specifiedBy("The specifiedBy URL points to a human-readable specifica
 scalar Date
 
 "The `DateTime` scalar represents an ISO-8601 compliant date time type."
-scalar DateTime @specifiedBy(url: "https:\/\/www.graphql-scalars.com\/date-time")
+scalar DateTime @specifiedBy(url: "https:\/\/scalars.graphql.org\/andimarek\/date-time.html")
diff --git a/src/HotChocolate/ModelContextProtocol/src/HotChocolate.ModelContextProtocol/Extensions/TypeExtensions.cs b/src/HotChocolate/ModelContextProtocol/src/HotChocolate.ModelContextProtocol/Extensions/TypeExtensions.cs
@@ -183,7 +183,7 @@ private static bool TryGetJsonSchemaPattern(
                 // e.g. dmFsdWU= (Base64-encoded string)
                 => @"^(?:[A-Za-z0-9+\/]{4})*(?:[A-Za-z0-9+\/]{2}==|[A-Za-z0-9+\/]{3}=)?$",
             DateTimeType
-                // e.g. 2011-08-30T13:22:53.108Z (https://www.graphql-scalars.com/date-time/)
+                // e.g. 2011-08-30T13:22:53.108Z (https://scalars.graphql.org/andimarek/date-time.html)
                 =>
                     @"^\d{4}-\d{2}-\d{2}[Tt]\d{2}:\d{2}:\d{2}"
                     + @"(?:\.\d{1,7})?(?:[Zz]|[+-]\d{2}:\d{2})$",
diff --git a/src/HotChocolate/MongoDb/test/Data.MongoDb.Filters.Tests/__snapshots__/MongoDbFilterVisitorComparableTests.Create_Implicit_Operation.graphql b/src/HotChocolate/MongoDb/test/Data.MongoDb.Filters.Tests/__snapshots__/MongoDbFilterVisitorComparableTests.Create_Implicit_Operation.graphql
@@ -143,7 +143,7 @@ input FooFilterInput {
 directive @specifiedBy("The specifiedBy URL points to a human-readable specification. This field will only read a result for scalar types." url: String!) on SCALAR
 
 "The `DateTime` scalar represents an ISO-8601 compliant date time type."
-scalar DateTime @specifiedBy(url: "https:\/\/www.graphql-scalars.com\/date-time")
+scalar DateTime @specifiedBy(url: "https:\/\/scalars.graphql.org\/andimarek\/date-time.html")
 
 "The `Decimal` scalar type represents a decimal floating-point number."
 scalar Decimal
diff --git a/src/HotChocolate/MongoDb/test/Data.MongoDb.Filters.Tests/__snapshots__/MongoDbFilterVisitorComparableTests.Create_Implicit_Operation_Normalized.graphql b/src/HotChocolate/MongoDb/test/Data.MongoDb.Filters.Tests/__snapshots__/MongoDbFilterVisitorComparableTests.Create_Implicit_Operation_Normalized.graphql
@@ -128,7 +128,7 @@ input UuidOperationFilterInput {
 directive @specifiedBy("The specifiedBy URL points to a human-readable specification. This field will only read a result for scalar types." url: String!) on SCALAR
 
 "The `DateTime` scalar represents an ISO-8601 compliant date time type."
-scalar DateTime @specifiedBy(url: "https:\/\/www.graphql-scalars.com\/date-time")
+scalar DateTime @specifiedBy(url: "https:\/\/scalars.graphql.org\/andimarek\/date-time.html")
 
 "The `Decimal` scalar type represents a decimal floating-point number."
 scalar Decimal
diff --git a/src/Nitro/CommandLine/src/CommandLine.Cloud/schema.graphql b/src/Nitro/CommandLine/src/CommandLine.Cloud/schema.graphql
@@ -3531,7 +3531,7 @@ directive @defer("Deferred when true." if: Boolean "If this argument label has a
 scalar Any
 
 "The `DateTime` scalar represents an ISO-8601 compliant date time type."
-scalar DateTime @specifiedBy(url: "https:\/\/www.graphql-scalars.com\/date-time")
+scalar DateTime @specifiedBy(url: "https:\/\/scalars.graphql.org\/andimarek\/date-time.html")
 
 "The `Long` scalar type represents non-fractional signed whole 64-bit numeric values. Long can represent values between -(2^63) and 2^63 - 1."
 scalar Long
diff --git a/src/StrawberryShake/Client/src/Core/ThrowHelper.cs b/src/StrawberryShake/Client/src/Core/ThrowHelper.cs
@@ -19,7 +19,7 @@ internal static GraphQLClientException DateTimeSerializer_InvalidFormat(
         string serializedValue) =>
         new(new ClientError(
             "The serialized format for DateTime must be `yyyy-MM-ddTHH\\:mm\\:ss.fffzzz`. "
-            + "For more information read: `https://www.graphql-scalars.com/date-time`.",
+            + "For more information read: `https://scalars.graphql.org/andimarek/date-time.html`.",
             extensions: new Dictionary<string, object?>
             {
                     { "serializedValue", serializedValue }
diff --git a/src/StrawberryShake/CodeGeneration/test/CodeGeneration.CSharp.Tests/__resources__/PaymentSchema.graphql b/src/StrawberryShake/CodeGeneration/test/CodeGeneration.CSharp.Tests/__resources__/PaymentSchema.graphql
@@ -7676,7 +7676,7 @@ directive @stream("Streamed when true." if: Boolean "The initial elements that s
 scalar Date
 
 "The `DateTime` scalar represents an ISO-8601 compliant date time type."
-scalar DateTime @specifiedBy(url: "https:\/\/www.graphql-scalars.com\/date-time")
+scalar DateTime @specifiedBy(url: "https:\/\/scalars.graphql.org\/andimarek\/date-time.html")
 
 "The `Decimal` scalar type represents a decimal floating-point number."
 scalar Decimal
diff --git a/website/src/docs/hotchocolate/v16/defining-a-schema/scalars.md b/website/src/docs/hotchocolate/v16/defining-a-schema/scalars.md
@@ -170,7 +170,7 @@ Notice how our code uses `int` for the `Id`, but in a request / response it woul
 
 # GraphQL Community Scalars
 
-The website <https://www.graphql-scalars.com/> hosts specifications for GraphQL scalars defined by the community. The community scalars use the `@specifiedBy` directive to point to the spec that is implemented.
+The website <https://scalars.graphql.org/> hosts specifications for GraphQL scalars defined by the community. The community scalars use the `@specifiedBy` directive to point to the spec that is implemented.
 
 ```sdl
 scalar UUID @specifiedBy(url: "https://tools.ietf.org/html/rfc4122")
@@ -183,7 +183,7 @@ A custom GraphQL scalar which represents an exact point in time. This point in t
 The DateTime scalar is based on [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339).
 
 ```sdl
-scalar DateTime @specifiedBy(url: "https://www.graphql-scalars.com/date-time/")
+scalar DateTime @specifiedBy(url: "https://scalars.graphql.org/andimarek/date-time.html")
 ```
 
 > Note: The Hot Chocolate implementation diverges slightly from the DateTime Scalar specification, and allows fractional seconds of 0-7 digits, as opposed to exactly 3.

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"data": {`
`3`	`3`	`"__type": {`
`4`		`- "specifiedByURL": "https://www.graphql-scalars.com/date-time"`
	`4`	`+ "specifiedByURL": "https://scalars.graphql.org/andimarek/date-time.html"`
`5`	`5`	`}`
`6`	`6`	`}`
`7`	`7`	`}`
Original file line number	Diff line number	Diff line change
`@@ -432,7 +432,7 @@ public static TheoryData<string, DateTimeOffset> ValidDateTimeScalarStrings()`
`432`	`432`	`{`
`433`	`433`	`return new TheoryData<string, DateTimeOffset>`
`434`	`434`	`{`
`435`		`- // https://www.graphql-scalars.com/date-time/#test-cases (valid strings)`
	`435`	`+ // https://scalars.graphql.org/andimarek/date-time.html#sec-Overview.Examples (valid examples)`
`436`	`436`	`{`
`437`	`437`	`// A DateTime with UTC offset (+00:00).`
`438`	`438`	`"2011-08-30T13:22:53.108Z",`
`@@ -476,7 +476,7 @@ public static TheoryData<string> InvalidDateTimeScalarStrings()`
`476`	`476`	`{`
`477`	`477`	`return`
`478`	`478`	`[`
`479`		`- // https://www.graphql-scalars.com/date-time/#test-cases (invalid strings)`
	`479`	`+ // https://scalars.graphql.org/andimarek/date-time.html#sec-Overview.Examples (invalid examples)`
`480`	`480`	`// The minutes of the offset are missing.`
`481`	`481`	`"2011-08-30T13:22:53.108-03",`
`482`	`482`	`// Too many digits for fractions of a second. Exactly three expected.`