Skip to content

Commit d8e9831

Browse files
committed
handle deprecated by team
1 parent 6caa093 commit d8e9831

1 file changed

Lines changed: 4 additions & 2 deletions

File tree

src/pages/learn/governance-tooling.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -270,7 +270,9 @@ Automated alerts ensure the right people know about schema issues without manual
270270
271271
### Alert on deprecated field usage
272272
273-
Schema-level `@deprecated` directives tell client developers that a field will go away, but they're easy to overlook. Usage-based alerts add concrete impact: which clients are still calling the field, how often, and how close the removal deadline is. This makes the notification actionable rather than informational.
273+
Client teams should detect `@deprecated` field usage at build time using linting or code generation tools, so deprecated references are caught before code ships. For example, GraphQL code generators and lint rules can flag deprecated field usage as warnings or errors during CI, preventing new usage from reaching production.
274+
275+
For backend teams, the problem is different: even after client teams stop adding new usage, older app versions may continue calling deprecated fields. Backend teams need runtime usage data to know when it's safe to remove a field. Set up alerts that notify backend owners as a deprecation deadline approaches and usage is still active.
274276
275277
```javascript
276278
async function checkDeprecationDeadlines(usageData, deprecations) {
@@ -290,7 +292,7 @@ async function checkDeprecationDeadlines(usageData, deprecations) {
290292
}
291293
```
292294
293-
This example checks usage against deprecation deadlines and notifies owners when clients haven't migrated.
295+
This gives backend teams visibility into real traffic so they can coordinate with client teams who still have active usage, rather than guessing when it's safe to remove a field.
294296
295297
### Alert on validation failures
296298

0 commit comments

Comments
 (0)