Skip to content

Commit 740ebbf

Browse files
authored
docs: change detection upgrade product update (#7322)
1 parent cf91128 commit 740ebbf

File tree

1 file changed

+35
-0
lines changed
  • packages/web/docs/src/app/product-updates/(posts)/2025-11-27-change-detection-upgrade

1 file changed

+35
-0
lines changed
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
title: Enhanced Schema Change Detection with Directive Support and Input Value Tracking
3+
description:
4+
A major upgrade to change detection, with more accurate severity levels and directive support.
5+
date: 2025-11-27
6+
authors: [jdolle]
7+
---
8+
9+
Breaking change detection is complicated, but it's an incredibly valuable tool for any API. In our
10+
latest release, we upgraded this detection to make breaking changes even more accurate and provide a
11+
more complete set of changes for schema checks.
12+
13+
These have been highly requested features, but our hope is that this change goes mostly unnoticed
14+
because that means it's working and that the changes are tracked accurately.
15+
16+
The technical set of changes are:
17+
18+
- `FieldDeprecationRemoved` severity is changing from "dangerous" to "non-breaking". This is because
19+
deprecation does not impact behavior.
20+
- `InputFieldAdded` is now "non-breaking" IF a default value is set for the input. Previously only
21+
nullability was taken into account. This is because the default value will be provided
22+
automatically, so non-nullable inputs still don't need passed by clients.
23+
- A redundant DeprecationAdded and DeprecationRemoved change was removed.
24+
- And `DirectiveUsage` changes are being tracked. E.g. `DirectiveUsageEnumRemoved` and
25+
`DirectiveUsageObjectAdded`. A similar set of usage events were added for arguments as well.
26+
27+
---
28+
29+
This upgrade also lays the foundation for the upcoming feature, schema proposals, which is powered
30+
by [GraphQL Inspector](https://the-guild.dev/graphql/inspector) for change capture and rebasing
31+
changes on top of schemas.
32+
33+
For more insights on the schema proposals work being done, refer to our
34+
[Schema Proposal Review](https://the-guild.dev/graphql/hive/product-updates/2025-09-03-schema-proposals)
35+
update.

0 commit comments

Comments
 (0)