跳转到主要内容

协作指南

内容、开发及部署说明。

docs/ 目前只有少量长期指南,保持平铺。英文文件为准,同名 .zh.md 提供中文参考。_index.md / _index.zh.md 是本目录地图及 OINK 栏目页面。

指南职责
本地开发环境/依赖安装,本地服务启动/停止,运行检查及查看产物。
开发流程Worktree、所选审查、文档归属、验收及 commit/PR 规则。
内容编写Markdown schema、译文配对、新增内容及草稿发布。
部署设置GitHub/Cloudflare 配置、生产发布、验证与回滚。

这里放长期复用操作,行为变化时修改已有主题页。只有独立且会反复使用的主题才新增指南,多个相关指南确有分组需求时再加子目录。需求、决策、审查和简明证据放在 logs/changes/<id>/index.md / index.zh.md;临时中文验收手册只放被忽略的 .local/acceptance/<id>.md,不放入本公开目录。