移除流程
下线一个源仓前,先判断你要做的是哪一种动作:
- 暂停自动联动:保留根仓登记,只停掉源仓通知 workflow
- 完整移除:同时移除源仓通知和根仓登记
1. 只暂停自动联动
在源仓执行:
uvx --from 'docs-stratego==<version>' docs-stratego source scaffold-notify \
--repo-path /path/to/source-repo \
--remove
适用场景:
- 源仓暂时冻结
- 文档还需要保留在聚合站点
- 你想先人工控制更新节奏
如果 CLI 还没有对外发布,请先看 CLI 分发与发布,不要默认在源仓里执行 uv run docs-stratego ...。
2. 完整移除一个源仓
建议按下面顺序做:
- 在源仓删除通知 workflow。
- 在根仓移除仓库定义。
- 如果该源仓使用 remote submodule,再移除 submodule。
- 重新跑一次根仓远程构建验证。
根仓命令:
uv run docs-stratego source remove \
--project-root /path/to/docs-stratego \
--name atlas \
--yes
如果要连 submodule 一起移除,再追加:
--remove-submodule
如果你只想看即将删除什么,不真正落盘,追加:
--dry-run
3. 完整移除后的验证
在根仓执行:
uv run docs-stratego sync --project-root /path/to/docs-stratego --source-mode remote
uv run docs-stratego build --project-root /path/to/docs-stratego --source-mode remote
uv run mkdocs build -f /path/to/docs-stratego/.generated/mkdocs.generated.yml -d /path/to/docs-stratego/site
确认目标:
config/source-repos.json已不再包含该仓库.gitmodules与sources/<name>状态一致- 站点构建不再引用该源仓页面
4. 下线验收清单
- [ ] 源仓通知 workflow 已删除或停用
- [ ] 根仓仓库定义已移除
- [ ] 如适用,submodule 已移除
- [ ] 远程模式构建通过
- [ ] 维护者已知晓聚合站点内容会减少该项目入口