Skip to content

Align built-in scalar descriptions with the spec#9180

Merged
glen-84 merged 2 commits intomainfrom
gai/align-scalar-descriptions
Feb 24, 2026
Merged

Align built-in scalar descriptions with the spec#9180
glen-84 merged 2 commits intomainfrom
gai/align-scalar-descriptions

Conversation

@glen-84
Copy link
Copy Markdown
Member

@glen-84 glen-84 commented Feb 23, 2026

Summary of the changes (Less than 80 chars)

  • Align built-in scalar descriptions with the spec.

Copilot AI review requested due to automatic review settings February 23, 2026 16:00
@github-actions github-actions Bot added 📚 documentation This issue is about working on our documentation. 🌶️ hot chocolate 🌶️ strawberry shake labels Feb 23, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the built-in GraphQL scalar descriptions (and corresponding test fixtures/docs) to match the current spec wording, ensuring introspection outputs and docs remain consistent across HotChocolate and Strawberry Shake.

Changes:

  • Updated built-in scalar descriptions for String, Int, ID, and Float (including the IEEE 754 link + wording tweaks).
  • Regenerated/updated introspection-related snapshots and test resource JSON to reflect the new descriptions.
  • Updated Strawberry Shake v16 scalar documentation to match the new spec-aligned descriptions.

Reviewed changes

Copilot reviewed 12 out of 13 changed files in this pull request and generated no comments.

Show a summary per file
File Description
website/src/docs/strawberryshake/v16/scalars.md Updates scalar description text (and table formatting) to spec-aligned wording.
src/StrawberryShake/CodeGeneration/test/CodeGeneration.CSharp.Tests/Integration/snapshots/StarWarsIntrospectionTest.Execute_StarWarsIntrospection_Test.snap Updates expected introspection snapshot descriptions for built-in scalars.
src/HotChocolate/Utilities/test/Utilities.Introspection.Tests/snapshots/IntrospectionFormatterTests.DeserializeStarWarsIntrospectionResult.snap Updates expected SDL snapshot descriptions for built-in scalars.
src/HotChocolate/Utilities/test/Utilities.Introspection.Tests/resources/StarWarsIntrospectionResult.json Updates stored introspection JSON resource descriptions for built-in scalars.
src/HotChocolate/Core/test/Validation.Tests/snapshots/InputObjectRequiredFieldsRuleTests.InvalidInputObjectPartialObjectMissingRequired.snap Updates expected schema snapshot string scalar description.
src/HotChocolate/Core/test/Types.Tests/snapshots/SchemaFirstTests.Interfaces_Impl_Interfaces_Are_Correctly_Exposed_Through_Introspection.snap Updates expected introspection snapshot string scalar description.
src/HotChocolate/Core/test/Types.Tests/snapshots/SchemaFirstTests.DescriptionsAreCorrectlyRead.snap Updates expected introspection snapshot string scalar description.
src/HotChocolate/Core/test/Execution.Tests/snapshots/IntrospectionTests.ExecuteGraphiQLIntrospectionQuery_ToJson.snap Updates expected introspection JSON snapshot string scalar description.
src/HotChocolate/Core/test/Execution.Tests/snapshots/IntrospectionTests.ExecuteGraphiQLIntrospectionQuery.snap Updates expected introspection snapshot string scalar description.
src/HotChocolate/Core/test/Execution.Tests/snapshots/IntrospectionTests.DefaultValueIsInputObject.snap Updates expected introspection snapshot string scalar description.
src/HotChocolate/Core/test/Execution.Tests/Integration/StarWarsCodeFirst/snapshots/StarWarsCodeFirstTests.Ensure_Benchmark_Query_LargeQuery.snap Updates expected introspection snapshot descriptions for built-in scalars.
src/HotChocolate/Core/src/Types/Properties/TypeResources.resx Updates localized built-in scalar description strings (source of runtime descriptions).
src/HotChocolate/Core/src/Types/Properties/TypeResources.Designer.cs Updates generated strongly-typed resource accessor doc comments to match resx changes.
Files not reviewed (1)
  • src/HotChocolate/Core/src/Types/Properties/TypeResources.Designer.cs: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Feb 23, 2026

Fusion Gateway Performance Results

Simple Composite Query

Req/s Err%
Constant (50 VUs) 2920.05 0.00%
Ramping (0-500-0 VUs) 3372.39 0.00%
Response Times & Query
Min Med Avg P90 P95 Max
Constant 0.74ms 15.09ms 16.90ms 30.97ms 36.46ms 171.73ms
Ramping 0.71ms 64.01ms 66.06ms 123.71ms 142.39ms 264.08ms
query TestQuery {
  topProducts(first: 5) {
    inStock
    name
    price
    shippingEstimate
    upc
    weight
    reviews {
      id
      body
      author {
        id
        username
        name
      }
    }
  }
}

Deep Recursion Query

Req/s Err%
Constant (50 VUs) 746.00 0.00%
Ramping (0-500-0 VUs) 827.71 0.00%
Response Times & Query
Min Med Avg P90 P95 Max
Constant 8.98ms 62.61ms 65.49ms 81.29ms 89.20ms 337.72ms
Ramping 1.79ms 250.67ms 259.26ms 522.08ms 566.14ms 707.02ms
query TestQuery {
  users {
    id
    username
    name
    reviews {
      id
      body
      product {
        inStock
        name
        price
        shippingEstimate
        upc
        weight
        reviews {
          id
          body
          author {
            id
            username
            name
            reviews {
              id
              body
              product {
                inStock
                name
                price
                shippingEstimate
                upc
                weight
              }
            }
          }
        }
      }
    }
  }
  topProducts(first: 5) {
    inStock
    name
    price
    shippingEstimate
    upc
    weight
    reviews {
      id
      body
      author {
        id
        username
        name
        reviews {
          id
          body
          product {
            inStock
            name
            price
            shippingEstimate
            upc
            weight
          }
        }
      }
    }
  }
}

Variable Batching Throughput

Req/s Err%
Constant (50 VUs) 23598.35 0.00%
Ramping (0-500-0 VUs) 18583.57 0.00%
Response Times & Query
Min Med Avg P90 P95 Max
Constant 0.10ms 1.70ms 2.07ms 3.95ms 4.83ms 36.28ms
Ramping 0.10ms 9.38ms 11.33ms 23.19ms 28.10ms 98.16ms
query TestQuery($upc: ID!, $price: Long!, $weight: Long!) {
  productByUpc(upc: $upc) {
    inStock
    shippingEstimate(weight: $weight, price: $price)
  }
}

Variables (5 sets batched per request)

[
  { "upc": "1", "price": 899, "weight": 100 },
  { "upc": "2", "price": 1299, "weight": 1000 },
  { "upc": "3", "price": 15, "weight": 20 },
  { "upc": "4", "price": 499, "weight": 100 },
  { "upc": "5", "price": 1299, "weight": 1000 }
]

Run 22340556394 • Commit 2e2eca8 • Tue, 24 Feb 2026 07:32:02 GMT

@glen-84 glen-84 merged commit 3905062 into main Feb 24, 2026
228 of 230 checks passed
@glen-84 glen-84 deleted the gai/align-scalar-descriptions branch February 24, 2026 07:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

📚 documentation This issue is about working on our documentation. 🌶️ hot chocolate 🌶️ strawberry shake

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants