Deprecations

Purpose

Retire functionality safely without disrupting users or downstream systems.

Procedure

1. Create a Linear Project to track the deprecation work.
2. Identify all consumers and required migration steps.
3. Add deprecation notes to relevant docs and interfaces.
4. Provide a migration window and remove usage over time.
5. Remove the deprecated functionality after all consumers are migrated.

Notes

• Coordinate timelines with product and partner stakeholders.
• Use feature flags when you need a staged shutdown.