Skip to content

Align built-in scalar descriptions with the spec #9180

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
glen-84 merged 2 commits into from
Feb 24, 2026
Merged

Align built-in scalar descriptions with the spec #9180

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8704cb4
Align built-in scalar descriptions with the spec
glen-84 Feb 23, 2026
0ee6556
Merge branch 'main' into gai/align-scalar-descriptions
glen-84 Feb 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions src/HotChocolate/Core/src/Types/Properties/TypeResources.Designer.cs
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

8 changes: 4 additions & 4 deletions src/HotChocolate/Core/src/Types/Properties/TypeResources.resx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -174,10 +174,10 @@ In some cases, you need to provide options to alter GraphQL's execution behavior
<value>Object and Interface types are described by a list of Fields, each of which has a name, potentially a list of arguments, and a return type.</value>
</data>
<data name="FloatType_Description" xml:space="preserve">
<value>The `Float` scalar type represents signed double-precision fractional values as specified by [IEEE 754](http://en.wikipedia.org/wiki/IEEE_floating_point).</value>
<value>The `Float` scalar type represents signed double-precision finite values as specified by [IEEE 754](https://en.wikipedia.org/wiki/IEEE_floating_point).</value>
</data>
<data name="IdType_Description" xml:space="preserve">
<value>The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"4"`) or integer (such as `4`) input value will be accepted as an ID.</value>
<value>The `ID` scalar type represents a unique identifier, often used to refetch an object or as the key for a cache.</value>
</data>
<data name="InputField_CannotSetValue" xml:space="preserve">
<value>Unable to set the input field value.</value>
Expand Down Expand Up @@ -219,7 +219,7 @@ In some cases, you need to provide options to alter GraphQL's execution behavior
<value>The interface type extension can only be merged with an interface type.</value>
</data>
<data name="IntType_Description" xml:space="preserve">
<value>The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.</value>
<value>The `Int` scalar type represents a signed 32-bit numeric non-fractional value.</value>
</data>
<data name="LongType_Description" xml:space="preserve">
<value>The `Long` scalar type represents a signed 64-bit integer.</value>
Expand Down Expand Up @@ -333,7 +333,7 @@ In some cases, you need to provide options to alter GraphQL's execution behavior
<value>The `Short` scalar type represents a signed 16-bit integer.</value>
</data>
<data name="StringType_Description" xml:space="preserve">
<value>The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.</value>
<value>The `String` scalar type represents textual data, represented as a sequence of Unicode code points.</value>
</data>
<data name="String_Argument_NullOrEmpty" xml:space="preserve">
<value>The `{0}` cannot be null or empty.</value>
Expand Down
8 changes: 4 additions & 4 deletions ...WarsCodeFirst/__snapshots__/StarWarsCodeFirstTests.Ensure_Benchmark_Query_LargeQuery.snap
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6634,7 +6634,7 @@
{
"kind": "SCALAR",
"name": "String",
"description": "The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.",
"description": "The `String` scalar type represents textual data, represented as a sequence of Unicode code points.",
"fields": null,
"inputFields": null,
"interfaces": null,
Expand Down Expand Up @@ -6912,7 +6912,7 @@
{
"kind": "SCALAR",
"name": "ID",
"description": "The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `\"4\"`) or integer (such as `4`) input value will be accepted as an ID.",
"description": "The `ID` scalar type represents a unique identifier, often used to refetch an object or as the key for a cache.",
"fields": null,
"inputFields": null,
"interfaces": null,
Expand Down Expand Up @@ -6985,7 +6985,7 @@
{
"kind": "SCALAR",
"name": "Int",
"description": "The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.",
"description": "The `Int` scalar type represents a signed 32-bit numeric non-fractional value.",
"fields": null,
"inputFields": null,
"interfaces": null,
Expand All @@ -6995,7 +6995,7 @@
{
"kind": "SCALAR",
"name": "Float",
"description": "The `Float` scalar type represents signed double-precision fractional values as specified by [IEEE 754](http://en.wikipedia.org/wiki/IEEE_floating_point).",
"description": "The `Float` scalar type represents signed double-precision finite values as specified by [IEEE 754](https://en.wikipedia.org/wiki/IEEE_floating_point).",
"fields": null,
"inputFields": null,
"interfaces": null,
Expand Down
2 changes: 1 addition & 1 deletion ...Core/test/Execution.Tests/__snapshots__/IntrospectionTests.DefaultValueIsInputObject.snap
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1042,7 +1042,7 @@
{
"kind": "SCALAR",
"name": "String",
"description": "The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.",
"description": "The `String` scalar type represents textual data, represented as a sequence of Unicode code points.",
"specifiedByURL": null,
"fields": null,
"inputFields": null,
Expand Down
2 changes: 1 addition & 1 deletion ...t/Execution.Tests/__snapshots__/IntrospectionTests.ExecuteGraphiQLIntrospectionQuery.snap
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1091,7 +1091,7 @@
{
"kind": "SCALAR",
"name": "String",
"description": "The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.",
"description": "The `String` scalar type represents textual data, represented as a sequence of Unicode code points.",
"specifiedByURL": null,
"fields": null,
"inputFields": null,
Expand Down
2 changes: 1 addition & 1 deletion ...tion.Tests/__snapshots__/IntrospectionTests.ExecuteGraphiQLIntrospectionQuery_ToJson.snap
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1091,7 +1091,7 @@
{
"kind": "SCALAR",
"name": "String",
"description": "The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.",
"description": "The `String` scalar type represents textual data, represented as a sequence of Unicode code points.",
"specifiedByURL": null,
"fields": null,
"inputFields": null,
Expand Down
2 changes: 1 addition & 1 deletion ...te/Core/test/Types.Tests/__snapshots__/SchemaFirstTests.DescriptionsAreCorrectlyRead.snap
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1231,7 +1231,7 @@
{
"kind": "SCALAR",
"name": "String",
"description": "The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.",
"description": "The `String` scalar type represents textual data, represented as a sequence of Unicode code points.",
"fields": null,
"inputFields": null,
"interfaces": null,
Expand Down
2 changes: 1 addition & 1 deletion ...emaFirstTests.Interfaces_Impl_Interfaces_Are_Correctly_Exposed_Through_Introspection.snap
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1113,7 +1113,7 @@
{
"kind": "SCALAR",
"name": "String",
"description": "The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.",
"description": "The `String` scalar type represents textual data, represented as a sequence of Unicode code points.",
"fields": null,
"inputFields": null,
"interfaces": null,
Expand Down
2 changes: 1 addition & 1 deletion ...__/InputObjectRequiredFieldsRuleTests.InvalidInputObjectPartialObjectMissingRequired.snap
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@
"Directives": [],
"SyntaxNode": null,
"Name": "String",
"Description": "The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text."
"Description": "The `String` scalar type represents textual data, represented as a sequence of Unicode code points."
},
"ClrType": "System.Collections.Generic.List`1[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]], System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e"
},
Expand Down
8 changes: 4 additions & 4 deletions ...ilities/test/Utilities.Introspection.Tests/__resources__/StarWarsIntrospectionResult.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
"types": [{
"kind": "SCALAR",
"name": "String",
"description": "The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.",
"description": "The `String` scalar type represents textual data, represented as a sequence of Unicode code points.",
"fields": null,
"inputFields": null,
"interfaces": null,
Expand All @@ -23,7 +23,7 @@
{
"kind": "SCALAR",
"name": "ID",
"description": "The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `\"4\"`) or integer (such as `4`) input value will be accepted as an ID.",
"description": "The `ID` scalar type represents a unique identifier, often used to refetch an object or as the key for a cache.",
"fields": null,
"inputFields": null,
"interfaces": null,
Expand All @@ -43,7 +43,7 @@
{
"kind": "SCALAR",
"name": "Int",
"description": "The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.",
"description": "The `Int` scalar type represents a signed 32-bit numeric non-fractional value.",
"fields": null,
"inputFields": null,
"interfaces": null,
Expand All @@ -53,7 +53,7 @@
{
"kind": "SCALAR",
"name": "Float",
"description": "The `Float` scalar type represents signed double-precision fractional values as specified by [IEEE 754](http://en.wikipedia.org/wiki/IEEE_floating_point).",
"description": "The `Float` scalar type represents signed double-precision finite values as specified by [IEEE 754](https://en.wikipedia.org/wiki/IEEE_floating_point).",
"fields": null,
"inputFields": null,
"interfaces": null,
Expand Down
8 changes: 4 additions & 4 deletions ...sts/__snapshots__/IntrospectionFormatterTests.DeserializeStarWarsIntrospectionResult.snap
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,19 +4,19 @@ schema {
subscription: Subscription
}

"The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text."
"The `String` scalar type represents textual data, represented as a sequence of Unicode code points."
scalar String

"The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `\"4\"`) or integer (such as `4`) input value will be accepted as an ID."
"The `ID` scalar type represents a unique identifier, often used to refetch an object or as the key for a cache."
scalar ID

"The `Boolean` scalar type represents `true` or `false`."
scalar Boolean

"The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1."
"The `Int` scalar type represents a signed 32-bit numeric non-fractional value."
scalar Int

"The `Float` scalar type represents signed double-precision fractional values as specified by [IEEE 754](http://en.wikipedia.org/wiki/IEEE_floating_point)."
"The `Float` scalar type represents signed double-precision finite values as specified by [IEEE 754](https://en.wikipedia.org/wiki/IEEE_floating_point)."
scalar Float

scalar Decimal
Expand Down
16 changes: 8 additions & 8 deletions ...tegration/__snapshots__/StarWarsIntrospectionTest.Execute_StarWarsIntrospection_Test.snap
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1723,7 +1723,7 @@
{
"Kind": "Scalar",
"Name": "String",
"Description": "The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.",
"Description": "The `String` scalar type represents textual data, represented as a sequence of Unicode code points.",
"Fields": null,
"InputFields": null,
"Interfaces": null,
Expand All @@ -1743,7 +1743,7 @@
{
"Kind": "Scalar",
"Name": "Int",
"Description": "The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.",
"Description": "The `Int` scalar type represents a signed 32-bit numeric non-fractional value.",
"Fields": null,
"InputFields": null,
"Interfaces": null,
Expand Down Expand Up @@ -2011,7 +2011,7 @@
{
"Kind": "Scalar",
"Name": "ID",
"Description": "The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `\"4\"`) or integer (such as `4`) input value will be accepted as an ID.",
"Description": "The `ID` scalar type represents a unique identifier, often used to refetch an object or as the key for a cache.",
"Fields": null,
"InputFields": null,
"Interfaces": null,
Expand Down Expand Up @@ -2084,7 +2084,7 @@
{
"Kind": "Scalar",
"Name": "Float",
"Description": "The `Float` scalar type represents signed double-precision fractional values as specified by [IEEE 754](http://en.wikipedia.org/wiki/IEEE_floating_point).",
"Description": "The `Float` scalar type represents signed double-precision finite values as specified by [IEEE 754](https://en.wikipedia.org/wiki/IEEE_floating_point).",
"Fields": null,
"InputFields": null,
"Interfaces": null,
Expand Down Expand Up @@ -5657,7 +5657,7 @@
"__typename": "__Type",
"Name": "String",
"Kind": "Scalar",
"Description": "The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.",
"Description": "The `String` scalar type represents textual data, represented as a sequence of Unicode code points.",
"Fields": null,
"InputFields": null,
"Interfaces": null,
Expand All @@ -5681,7 +5681,7 @@
"__typename": "__Type",
"Name": "Int",
"Kind": "Scalar",
"Description": "The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.",
"Description": "The `Int` scalar type represents a signed 32-bit numeric non-fractional value.",
"Fields": null,
"InputFields": null,
"Interfaces": null,
Expand Down Expand Up @@ -6149,7 +6149,7 @@
"__typename": "__Type",
"Name": "ID",
"Kind": "Scalar",
"Description": "The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `\"4\"`) or integer (such as `4`) input value will be accepted as an ID.",
"Description": "The `ID` scalar type represents a unique identifier, often used to refetch an object or as the key for a cache.",
"Fields": null,
"InputFields": null,
"Interfaces": null,
Expand Down Expand Up @@ -6278,7 +6278,7 @@
"__typename": "__Type",
"Name": "Float",
"Kind": "Scalar",
"Description": "The `Float` scalar type represents signed double-precision fractional values as specified by [IEEE 754](http://en.wikipedia.org/wiki/IEEE_floating_point).",
"Description": "The `Float` scalar type represents signed double-precision finite values as specified by [IEEE 754](https://en.wikipedia.org/wiki/IEEE_floating_point).",
"Fields": null,
"InputFields": null,
"Interfaces": null,
Expand Down
Loading
Loading