UI 视觉设计 / 知识点
设计系统术语速查手册
治理与演进
为重大版本、弃用能力或 Token 重构提供旧用法到新用法的明确映射、步骤、检查项和风险说明,降低升级成本。
定义
**Migration Guide(迁移指南)**告诉使用方如何从旧版本安全移动到新版本。
高质量迁移指南应包含:
text
What changed
Who is affected
Old → New mapping
Migration steps
Validation
Known issues边界
Release Notes 说明“变了什么”,Migration Guide 重点回答“我该怎么改”。
最小例子
Token 重命名时直接给出 old.token → new.token 映射表,比只宣布“Token 架构升级”更可执行。
常见误区
不要在大版本发布后才补迁移指南。迁移成本本身应该在 Breaking Change 评审阶段被评估。