文档协作与发布

ADPS 的模式、模块总纲、案例、研讨记录、概念和专题在本仓库维护。读者可以在网页上针对段落提建议,也可以直接修改这里的文档,提交 Pull Request(PR)。

提出修改

  1. 文档目录找到文章,点击 GitHub 的编辑按钮。没有仓库写权限也可以通过 Fork 提交。
  2. 修改具体段落。技术补充请写明应用场景、解决办法和适用条件,并提供可公开的来源。修复错字不需要写长篇说明。
  3. 检查对应的英文稿。事实、模式分类和案例发生变化时,两种语言一并更新。单独修复译名或错字,在 PR 中说明即可。
  4. 提交 PR,交代修改原因、涉及文章和验证方式。来自网页讨论的修改,附原讨论链接。

例如,一条建议指出“审批通过后,工具参数变化了,原来的批准不应继续有效”。修改稿应补充批准对象包含哪些字段、恢复执行时检查什么,以及哪些变化要求重新审批。评审围绕这些具体内容进行。

评审与采纳

领域评审者检查技术判断和证据,黄佳确认正文修订。自动检查负责文件、引用、图片和双语关系,不代替技术评审。专家成员身份不自动授予合并或发布权限。

批准针对 PR 的具体版本。批准后再修改内容,需要重新评审。PR 合并后成为已采纳源稿,尚未发布的修订可以继续在 GitHub 阅读。

网站发布

发布者选择一个确定的源稿提交,构建预览,检查中英文、图片、链接和段落讨论的位置。黄佳确认后,发布者提交网站发布 PR。部署成功并核对线上结果后,记录源稿提交、网站提交和发布标签。

网站文末的“查看发布源稿”指向当前页面使用的确切提交。“修订源稿”进入正在维护的主分支。网站可能暂时落后于已合并的新稿,但不会存在另一份独立维护的正文。紧急修复也先回到源稿,再发布。

网页讨论

网页上的“批准公开”只让建议对读者可见,不表示正文已经采纳。维护者把需要改稿的公开建议关联到 GitHub Issue,再通过 PR 修改正文。Issue 保留原页面、段落和原文版本,避免把旧建议套到改过的新段落上。

未公开投稿、原始聊天、内部评审笔记、私人联系方式和未获确认的材料不进入本公开仓库。撤回公开意见时,也应联系维护者处理已关联的 Issue。

文件与贡献记录

代码与文档共用仓库,不共用修改范围。只改文章的 PR 不应顺便调整运行代码、测试或部署配置。由 Agent 辅助起草的修改,提交者同样需要核对事实、来源和改动范围。