docs: synchronize 1.2.2 manual and book release anchors - #5223
Conversation
huangruiteng
left a comment
There was a problem hiding this comment.
Reviewed head: 5223@388249176be6a5af2425db343815d8b8ed74092f
动机
1.2.2 发布前验证发现两个真实缺口:现有 resolve-peer-route 命令未被命令目录或 help-only 集合覆盖,完整公开 smoke 因此失败;Developer Book 的四个当前版本锚点与生成的手册仍写 1.2.1,网站发布检查失败。维护者已授权本次发布所需修复与合并。
改动思路
复用 COMMAND_GROUPS 作为 commands 与 manpage 的单一公开目录,在既有 agent-directory 后加入已经存在的精确 peer 路由读取命令,再用 render-manpage 生成手册。双语书籍只同步当前发行版本;历史迁移里程碑保持其原有含义。无需新增文档生成体系或修改检查条件。
具体改动
完整差异为六个文件、13 行增加和 6 行删除。帮助目录增加四行,生成的手册增加该条目并更新头部版本;书籍四处当前版本说明对齐 1.2.2。实际 CLI、命令分类完整性、手册生成一致性及安装器路径均由既有 CLI/manual smoke 验证,Developer Book publication smoke 验证四个锚点,均已通过。Ruff、空白、公开边界、精确差异质量与风险预合入检查通过。没有新的执行或授权行为;commands 的目录增加一项,默认简洁 help 与 resolve-peer-route 参数和拒绝行为保留。网页变化位于已有版本基线正文下部,不涉及首屏、主 CTA 或导航。
对主干的风险
遗漏手册生成会继续造成发行身份不一致;当前提交保留生成一致性断言。添加错误命令分类会让 parser/manual 分类不符;原始失败及 head 的现有 smoke 证明分类敏感性。中英文 release anchor 必须一致,本次同时同步四处。没有放宽 CI、预算、权限或默认激活。发布前仍需在最终合入提交重新执行完整发布资格,不能把此次局部文档验证当成已发布或已安装。
我的整体评价
当前精确 head 可以批准,范围覆盖已证明的两个发行缺口。相邻边界已检查:继续使用现有目录、生成器与版本校验,不需要新增抽象;没有值得夹带的额外重构。已完成正向和原始失败对照,剩余完整 CI、实际模型与公开工件验收由同一次发行继续负责。评审发布于当前 head,合并使用维护者已有授权。
English verdict: APPROVE
Signed-off-by: huangruiteng <14976749+huangruiteng@users.noreply.github.com>
3882491 to
6cb1b21
Compare
huangruiteng
left a comment
There was a problem hiding this comment.
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
Reviewed head: 5223@6cb1b21570cd5da791073c97e70dfae1d1ac01f8
动机
1.2.2 发布前验证发现两个真实缺口:现有 resolve-peer-route 命令未被命令目录或 help-only 集合覆盖,完整公开 smoke 因此失败;Developer Book 的四个当前版本锚点与生成的手册仍写 1.2.1,网站发布检查失败。维护者已授权本次发布所需修复与合并。
改动思路
复用 COMMAND_GROUPS 作为 commands 与 manpage 的单一公开目录,在既有 agent-directory 后加入已经存在的精确 peer 路由读取命令,再用 render-manpage 生成手册。双语书籍只同步当前发行版本;历史迁移里程碑保持其原有含义。无需新增文档生成体系或修改检查条件。
具体改动
完整差异为六个文件、13 行增加和 6 行删除。帮助目录增加四行,生成的手册增加该条目并更新头部版本;书籍四处当前版本说明对齐 1.2.2。实际 CLI、命令分类完整性、手册生成一致性及安装器路径均由既有 CLI/manual smoke 验证,Developer Book publication smoke 验证四个锚点,均已通过。Ruff、空白、公开边界、精确差异质量与风险预合入检查通过。没有新的执行或授权行为;commands 的目录增加一项,默认简洁 help 与 resolve-peer-route 参数和拒绝行为保留。网页变化位于已有版本基线正文下部,不涉及首屏、主 CTA 或导航。
对主干的风险
遗漏手册生成会继续造成发行身份不一致;当前提交保留生成一致性断言。添加错误命令分类会让 parser/manual 分类不符;原始失败及 head 的现有 smoke 证明分类敏感性。中英文 release anchor 必须一致,本次同时同步四处。没有放宽 CI、预算、权限或默认激活。发布前仍需在最终合入提交重新执行完整发布资格,不能把此次局部文档验证当成已发布或已安装。
我的整体评价
当前精确 head 可以批准,范围覆盖已证明的两个发行缺口。相邻边界已检查:继续使用现有目录、生成器与版本校验,不需要新增抽象;没有值得夹带的额外重构。已完成正向和原始失败对照,剩余完整 CI、实际模型与公开工件验收由同一次发行继续负责。评审发布于当前 head,合并使用维护者已有授权。
English verdict: APPROVE
The 1.2.2 pre-publication workflows found that
resolve-peer-routewas absent from the canonical command catalog and that the generated manual and Developer Book still named 1.2.1. Add the shipped route command to the existing help owner, regenerate the manual, and align the four bilingual book version references with the package version.Validation: existing CLI/manual and Developer Book publication smokes, changed Python Ruff, whitespace and public boundary checks pass. Existing checks remain intact; this changes documentation discovery and release identity only. Final merged-source qualification and publication follow separately.