File tree Expand file tree Collapse file tree 1 file changed +31
-0
lines changed
packages/web/docs/src/app/product-updates/(posts)/2025-03-20-dangerous-change-approval Expand file tree Collapse file tree 1 file changed +31
-0
lines changed Original file line number Diff line number Diff line change
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 ) .
You can’t perform that action at this time.
0 commit comments