两种改法
- Git + PR（工程同学）
- 网页编辑器（不熟 Git 的同学）
- 从
main拉分支，比如docs/helvo-v2 - 本地运行
mint dev预览（默认http://localhost:3000） - 提交前运行
mint validate和mint broken-links - 提 PR，至少一位相关负责人 review 后合并
- 合并到
main后 Mintlify 自动部署
新增一个决策版本
- 在
decisions/新建YYYY-MM-DD-<主题>.mdx - 页面开头写清楚：状态、决策人、来源讨论链接、替代了哪个旧版本
- 在
docs.json的 Decisions 导航里加上这一页 - 旧版本不删，只在顶部加一行「已被 xxx 取代」