Skip to content

Commit e53bc9d

Browse files
authored
docs: add product update for dangerous change approvals (#6631)
1 parent ecb6928 commit e53bc9d

File tree

1 file changed

+31
-0
lines changed
  • packages/web/docs/src/app/product-updates/(posts)/2025-03-20-dangerous-change-approval

1 file changed

+31
-0
lines changed
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title: Require Approval for Dangerous Schema Changes
3+
description: Make schema changes safer with this simple opt-in setting.
4+
date: 2025-03-20
5+
authors: [jdolle]
6+
---
7+
8+
## What’s New?
9+
10+
- **Require approval for dangerous changes** – A new setting, configurable per Schema Target, to
11+
require approval for dangerous schema changes.
12+
13+
## Feature Details
14+
15+
We are constantly striving to make schema management easier and safer. One issue that isn't
16+
discussed so much is dangerous changes. These are technically safe changes from an API perspective,
17+
but are known to cause issues if systems are not built to handle them. An example is adding a new
18+
enum value.
19+
20+
A new enum value does not break existing values, but if the consumers of the API don't know how to
21+
handle this new case, and don't have a fallback, then it could cause undesirable behavior such as
22+
not rendering an element for an item in a list.
23+
24+
Requiring approval for dangerous changes doesn't entirely solve this issue, because it still
25+
requires the approver to manually verify that the change is safe. But it can help raise awareness
26+
that the change could cause issues and therefore empowers schema owners to better make decisions
27+
about their schema.
28+
29+
---
30+
31+
[For more information see the Target Management docs](/docs/management/targets#dangerous-changes).

0 commit comments

Comments
 (0)