迁移文档看起来是内容项目，实际经常变成链接运营项目。
客户有收藏夹，客服文章引用旧文档，销售 deck 链到 setup 页面，合作伙伴门户可能还指向旧指南。如果旧 URL 打不开，用户不会关心你换了文档系统，只会觉得链接坏了。
快速答案
文档 URL 迁移前，要先建立 redirect inventory。记录旧 URL、新目标、负责人、状态、近期访问和下线计划。重要文档应该跳到最接近的新页面，而不是全部跳首页。
PushUlink 可以帮助团队通过 Console 和 OpenAPI 创建、统计、替换和下线托管子域名转发入口。
为什么文档迁移会影响用户路径
文档链接会出现在很多地方：
- 产品里的帮助链接；
- 客服回复；
- onboarding 邮件；
- 搜索结果；
- API 教程；
- partner portal；
- 社区回答。
如果迁移只更新新文档站，外部引用仍然会留在旧世界。
应该盘点什么
每个重要旧文档入口都记录：
- 旧 URL 或子域名入口；
- 新目标；
- 产品模块；
- 负责人；
- 优先级；
- 近期访问；
- redirect 状态；
- 预计下线时间。
这样迁移不是一次性搬家，而是可控生命周期。
更友好的跳转规则
匹配用户意图
旧页面讲 API key，就跳到新的 API key 页面，不要只跳文档首页。
保留有用参数
如果链接里有来源或 campaign 参数，除非有明确原因，不要随便丢掉。
迁移后继续看访问
旧文档链接可能几个月后仍然有人点。访问数据能帮你判断是否保留。
负责人可见
每条 redirect 都应该有产品或文档负责人。
PushUlink 在这里解决什么
PushUlink 可以把 docs 相关入口和 redirect 当作可追踪对象管理。团队可以更新目标、查看访问统计、保留操作日志，并在旧引用消失后下线。
常见问题
每个文档 URL 都要这样管理吗？
不用。优先处理高访问页面、onboarding 路径、API setup、客户常用引用和产品内链接。
404 页面够不够？
重要文档通常不够。好的 redirect 可以减少用户中断和客服工单。
旧文档 redirect 什么时候能下线？
当访问下降，并确认产品、客服、partner 不再依赖时，再下线。
结论
文档迁移不是新站上线就结束。旧入口路径也要映射、观察、清理。
