协作指南
内容、开发及部署说明。
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,不放入本公开目录。