# Deprecation Policy

## Rules

- Do not remove a shared resource without documenting the replacement or the
  reason for removal.
- Prefer marking a resource deprecated in its description or body before
  deleting it.
- Keep migration guidance in the same change that introduces the replacement.