web/docs/migration-policy-v1-to-v2.md

15 lines
343 B
Markdown

# Migration Policy: v1 to v2
## Rules
1. v1 interfaces evolve additively only.
2. Breaking changes require v2 namespace.
3. v1 deprecation requires migration guide and overlap window.
## Required v2 Deliverables
1. Side-by-side API spec (`/v2`).
2. Schema migration map.
3. Backward compatibility notes.
4. Evidence continuity guarantees.