仓库里有一份关于「往云端上传文件前先列清单、让用户确认」的方案文档,里面有 28 个引用链接指向的是当初写稿人电脑上的临时文件夹,现在谁点都打不开。更麻烦的是,仓库有一道自动检查会核对改过的文档里的链接是否有效,所以下一个哪怕只改这份文档一个字的人,也会被这 28 条旧坏链拦住 —— 7 月已经真撞过一次,当时是绕过去的,没修。修法是把这些链接改成仓库内的相对位置,或者去掉链接只留文字,几分钟的事。不修的话,只要没人再碰这份文档就没有损失。
问题
docs/design/create-upload-manifest-v1.plan.md(upload epic alpha-work#8/#9/#10 随 #225 合入)含 28 行指向作者临时 worktree 的绝对路径 Markdown 链接,形如:
```
`packages/ui-mac/package.json:14`
```
这些 /Users/tide/app/alpha-code/.worktrees/225/... 路径只在原作者机器上存在,在 alpha 上永久失效。
影响
docs gate(alpha-ci.yml「Relative-link validity in changed Markdown」)已因此对下一个编辑或与该文件同 diff 的 docs PR 报红——本轮 #492(ADR-009)PR#512 首次撞上(30 broken of 34 checked),靠 rebase 绕过而非修复。任何后续触碰此文件的 docs PR 会被 docs-gate 拦。
修复
把 28 条绝对 .worktrees/225/... 链接改为仓库相对路径(如 ../../packages/ui-mac/package.json),或降级为纯 code-span(去掉链接、保留 \file:line`引用)——与 docs-gate 的scripts/check-doc-links.py 校验口径一致。退出条件:docs gate` 对该文件全绿(0 broken)。
边界
- 纯 docs 文案修复,零行为变更。
- 只动
docs/design/create-upload-manifest-v1.plan.md。
- 遵守 maintain-repository-docs 标准(不新增/移动/重命名文件,只修链接)。
发现于 W30 Ready 交付收尾(#492/#500 合入后)。
仓库里有一份关于「往云端上传文件前先列清单、让用户确认」的方案文档,里面有 28 个引用链接指向的是当初写稿人电脑上的临时文件夹,现在谁点都打不开。更麻烦的是,仓库有一道自动检查会核对改过的文档里的链接是否有效,所以下一个哪怕只改这份文档一个字的人,也会被这 28 条旧坏链拦住 —— 7 月已经真撞过一次,当时是绕过去的,没修。修法是把这些链接改成仓库内的相对位置,或者去掉链接只留文字,几分钟的事。不修的话,只要没人再碰这份文档就没有损失。
问题
docs/design/create-upload-manifest-v1.plan.md(upload epic alpha-work#8/#9/#10 随 #225 合入)含 28 行指向作者临时 worktree 的绝对路径 Markdown 链接,形如:```
`packages/ui-mac/package.json:14`
```
这些
/Users/tide/app/alpha-code/.worktrees/225/...路径只在原作者机器上存在,在 alpha 上永久失效。影响
docs gate(alpha-ci.yml「Relative-link validity in changed Markdown」)已因此对下一个编辑或与该文件同 diff 的 docs PR 报红——本轮 #492(ADR-009)PR#512 首次撞上(30 broken of 34 checked),靠 rebase 绕过而非修复。任何后续触碰此文件的 docs PR 会被 docs-gate 拦。修复
把 28 条绝对
.worktrees/225/...链接改为仓库相对路径(如../../packages/ui-mac/package.json),或降级为纯 code-span(去掉链接、保留\file:line`引用)——与 docs-gate 的scripts/check-doc-links.py校验口径一致。退出条件:docs gate` 对该文件全绿(0 broken)。边界
docs/design/create-upload-manifest-v1.plan.md。发现于 W30 Ready 交付收尾(#492/#500 合入后)。