Update spec URLs - #9521
#9521Merged
glen-84 merged 2 commits intoApr 10, 2026
mainChilliCream/graphql-platform:mainfrom
gai/update-spec-urlsChilliCream/graphql-platform:gai/update-spec-urlsCopy head branch name to clipboard
Merged
Update spec URLs#9521glen-84 merged 2 commits intomainChilliCream/graphql-platform:mainfrom gai/update-spec-urlsChilliCream/graphql-platform:gai/update-spec-urlsCopy head branch name to clipboard
glen-84 merged 2 commits into
mainChilliCream/graphql-platform:mainfrom
gai/update-spec-urlsChilliCream/graphql-platform:gai/update-spec-urlsCopy head branch name to clipboard
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Updates GraphQL specification URLs across Hot Chocolate v16 documentation, runtime error metadata/messages, and associated tests/snapshots to consistently reference the newer spec version.
Changes:
- Updated GraphQL spec links in docs and XML doc comments from June2018/October2021 to September2025.
- Updated
specifiedByURL generation and hard-codedspecifiedByextensions to the new spec version. - Updated unit tests and snapshot baselines to match the new URLs.
Reviewed changes
Copilot reviewed 87 out of 88 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| website/src/docs/hotchocolate/v16/api-reference/language.md | Updates spec links in the v16 language/AST reference table. |
| src/HotChocolate/Primitives/test/Primitives.Tests/NameUtilsTests.cs | Updates expected invalid-name error message URL. |
| src/HotChocolate/Primitives/src/Primitives/Properties/PrimitivesResources.resx | Updates invalid-name resource string to new spec URL. |
| src/HotChocolate/Primitives/src/Primitives/Properties/PrimitivesResources.Designer.cs | Regenerated strongly-typed resources; includes updated URL in doc comment/value. |
| src/HotChocolate/Language/src/Language.SyntaxTree/EnumTypeExtensionNode.cs | Updates XML doc spec URL. |
| src/HotChocolate/Language/src/Language.SyntaxTree/EnumTypeDefinitionNode.cs | Updates XML doc spec URL. |
| src/HotChocolate/Language/src/Language.SyntaxTree/DirectiveDefinitionNode.cs | Updates XML doc spec URL. |
| src/HotChocolate/Language/src/Language.SyntaxTree/BooleanValueNode.cs | Updates XML doc spec URL. |
| src/HotChocolate/Data/test/Data.Sorting.Tests/Convention/snapshots/SortConventionTests.SortConvention_Should_Fail_When_OperationsIsNotNamed.snap | Updates snapshot URL for invalid GraphQL name. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/ValuesOfCorrectTypeRuleTests.BadNullToString.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/ValuesOfCorrectTypeRuleTests.BadNullToNonNullField.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/ValuesOfCorrectTypeRuleTests.BadNullIntoNonNullString.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/ValuesOfCorrectTypeRuleTests.BadNullIntoNonNullInt.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/ValuesOfCorrectTypeRuleTests.BadNullIntoNonNullId.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/ValuesOfCorrectTypeRuleTests.BadNullIntoNonNullFloat.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/ValuesOfCorrectTypeRuleTests.BadNullIntoNonNullBool.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/ValuesOfCorrectTypeRuleTests.BadMultipleNullValueType.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/InputObjectRequiredFieldsRuleTests.InvalidInputObjectPartialObjectMissingRequired.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/FieldSelectionMergingRuleTests.DoesNotInfiniteLoopOnTransitivelyRecursiveFragment.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/FieldSelectionMergingRuleTests.DoesNotInfiniteLoopOnRecursiveFragment.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/FieldSelectionMergingRuleTests.DoesNotInfiniteLoopOnImmediatelyRecursiveFragment.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/FieldSelectionMergingRuleTests.ConflictingDifferingResponse.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/ExecutableDefinitionsRuleTests.GoodExecutableDefinitionsWithTypeDefinitions.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/ExecutableDefinitionsRuleTests.GoodExecutableDefinitionsWithSchemaDefinitions.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/DirectivesAreDefinedRuleTests.WithMisplacedDirectives.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/DeferAndStreamDirectivesAreUsedOnValidRootFieldTests.Defer_On_Mutation_Root.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Validation.Tests/snapshots/DeferAndStreamDirectivesAreUsedOnValidRootFieldTests.Defer_On_Mutation_Root_In_Nested_Fragment.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/ObjectTypeValidationRuleTests.RejectObjectTypeWithoutFields.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/ObjectTypeValidationRuleTests.RejectNonRequiredArgumentThatIsDeprecated.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/ObjectTypeValidationRuleTests.RejectInterfaceWithWrongImplementationOfArgument.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/ObjectTypeValidationRuleTests.RejectInterfaceWithWrongImplementation.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/ObjectTypeValidationRuleTests.RejectInterfaceWithNullableMismatchInImplementationOfField.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/ObjectTypeValidationRuleTests.RejectInterfaceWithNullableMismatchInImplementationOfArgument.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/ObjectTypeValidationRuleTests.RejectInterfaceWithMissingImplementationOfArgument.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/ObjectTypeValidationRuleTests.RejectInterfaceWithMissingImplementation.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/ObjectTypeValidationRuleTests.RejectFieldsWithInvalidName.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/InterfaceTypeValidationRuleTests.RejectNonRequiredArgumentThatIsDeprecated.snap | Updates specifiedBy URL(s) in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/InterfaceTypeValidationRuleTests.RejectFieldsWithInvalidName.snap | Updates specifiedBy URL(s) in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/InputObjectTypeValidationRuleTests.RejectsNonBreakableDirectCircularReference.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/InputObjectTypeValidationRuleTests.RejectsMultipleCircularReferences.snap | Updates specifiedBy URL(s) in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/InputObjectTypeValidationRuleTests.RejectsCircularReferenceThroughOtherType.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/InputObjectTypeValidationRuleTests.RejectRequiredFieldThatIsDeprecated.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/InputObjectTypeValidationRuleTests.RejectOneOfWithNullableFields.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/InputObjectTypeValidationRuleTests.RejectFieldsWithInvalidName.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/DirectiveValidationRuleTests.RejectRequiredArgumentThatIsDeprecated.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/DirectiveValidationRuleTests.RejectDirectiveWithInvalidName.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/Validation/snapshots/DirectiveValidationRuleTests.RejectArgumentsWithInvalidName.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/EnumTypeTests.cs | Updates inline snapshot URL for invalid GraphQL name. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/OneOfIntegrationTests.OneOf_Input_Objects_must_have_nullable_fields.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/OneOfIntegrationTests.OneOf_Input_Objects_must_have_nullable_fields_with_two_fields_that_have_default.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/OneOfIntegrationTests.OneOf_Input_Objects_must_have_nullable_fields_with_two_fields_non_null.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/OneOfIntegrationTests.OneOf_Input_Objects_must_have_nullable_fields_with_one_field_has_default.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/ObjectTypeTests.SchemaFirst_DeprecatedArgument_NonNullableIsDeprecated_Throw.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/ObjectTypeTests.CodeFirst_DeprecatedArgument_NonNullableIsDeprecated_Throw.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/ObjectTypeTests.AnnotationBased_DeprecatedArgument_NonNullableIsDeprecated_Throw.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/InterfaceTypeTests.SchemaFirst_DeprecatedArgumentsWithNonNullType_Invalid.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/InterfaceTypeTests.CodeFirst_DeprecatedArgumentsWithNonNullType_Invalid.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/InterfaceTypeTests.AnnotationBased_DeprecatedArgumentsWithNonNullType_Invalid.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/InputObjectTypeTests.SchemaFirst_DeprecatedInputTypes_NonNullableField_Invalid.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/InputObjectTypeTests.CodeFirst_DeprecatedInputTypes_NonNullableField_Invalid.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/InputObjectTypeTests.AnnotationBased_DeprecatedInputTypes_NonNullableField_Invalid.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/DirectiveTypeTests.SchemaFirst_DeprecatedDirective_NonNullableField_Invalid.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/DirectiveTypeTests.CodeFirst_DeprecatedInputTypes_NonNullableField_Invalid.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Types/snapshots/DirectiveTypeTests.AnnotationBased_DeprecatedInputTypes_NonNullableField_Invalid.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/ObjectTypeValidation.Object_Implements_Not_The_Interfaces_Of_Its_Interfaces.snap | Updates specifiedBy URL(s) in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/ObjectTypeValidation.Object_Implements_Not_The_Interfaces_Of_Its_Interfaces_2.snap | Updates specifiedBy URL(s) in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/ObjectTypeValidation.Implemented_Field_Is_NonNull_Field_Is_Nullable.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/ObjectTypeValidation.Implemented_Argument_Types_Do_Not_Match.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/ObjectTypeValidation.Fields_With_Two_Underscores_Are_Not_Allowed.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/ObjectTypeValidation.Field_Has_Additional_NonNull_Arguments.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/ObjectTypeValidation.Arguments_With_Two_Underscores_Are_Not_Allowed.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/ObjectTypeValidation.Arguments_Are_Not_Implemented.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/InterfaceTypeValidation.Interface_Implements_Not_The_Interfaces_Of_Its_Interfaces.snap | Updates specifiedBy URL in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/InterfaceTypeValidation.Fields_With_Two_Underscores_Are_Not_Allowed.snap | Updates specifiedBy URL(s) in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/InterfaceTypeValidation.Field_Is_Not_Implemented.snap | Updates specifiedBy URL(s) in snapshot output. |
| src/HotChocolate/Core/test/Types.Tests/Configuration/Validation/snapshots/InterfaceTypeValidation.Arguments_With_Two_Underscores_Are_Not_Allowed.snap | Updates specifiedBy URL(s) in snapshot output. |
| src/HotChocolate/Core/src/Validation/Rules/VariableVisitor.cs | Updates XML doc spec links for variable validation rules. |
| src/HotChocolate/Core/src/Validation/Rules/ValueVisitor.cs | Updates XML doc spec links for value/input validation rules. |
| src/HotChocolate/Core/src/Validation/Rules/OverlappingFieldsCanBeMergedRule.cs | Updates XML doc spec link for field selection merging. |
| src/HotChocolate/Core/src/Validation/Rules/OperationVisitor.cs | Updates XML doc spec links for operation validation rules. |
| src/HotChocolate/Core/src/Validation/Rules/FragmentVisitor.cs | Updates XML doc spec links for fragment validation rules. |
| src/HotChocolate/Core/src/Validation/Rules/DocumentRule.cs | Updates XML doc spec link for executable definitions. |
| src/HotChocolate/Core/src/Validation/Rules/DirectiveVisitor.cs | Updates XML doc spec links for directive validation rules. |
| src/HotChocolate/Core/src/Validation/Extensions/ValidationBuilderExtensions.cs | Updates XML doc spec links used by validation rule builder extensions. |
| src/HotChocolate/Core/src/Types/Utilities/ThrowHelper.cs | Updates hard-coded specifiedBy URL for list parsing/coercion error. |
| src/HotChocolate/Core/src/Types/Extensions/SchemaErrorBuilderExtensions.cs | Updates default spec version used for generated specifiedBy links. |
| src/HotChocolate/Core/src/Types.Abstractions/Types/NonNullType.cs | Updates XML doc spec URL. |
| src/HotChocolate/Core/src/Types.Abstractions/Types/ListType.cs | Updates XML doc spec URL. |
Files not reviewed (1)
- src/HotChocolate/Primitives/src/Primitives/Properties/PrimitivesResources.Designer.cs: Language not supported
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
This was referenced May 1, 2026
Open
This was referenced May 9, 2026
This was referenced May 16, 2026
This was referenced May 18, 2026
Closed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary of the changes (Less than 80 chars)