Repository navigation
docs: document saved Photo selections and optional approval #2160
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -105,17 +105,21 @@ node common/scripts/install-run-rush.js eslint --only tag:package | |
| | 存在待修复或待调查项 | 阅读问题,修复代码、补用例或提供可验证证据 | | ||
| | 流程受阻 | 查看具体待办;权限、服务或任务恢复问题交由维护者处理 | | ||
| | 等待人工批准 | 维护者核对当前版本的三项结果,并人工核查 Photo | | ||
| | 等待人工合入 | 当前提交的有效批准已识别,由维护者人工 Merge | | ||
| | 已合入/核对基准阶段 | 等待收尾;report-only 下跳过自动基准更新是预期行为 | | ||
| | 等待人工合入 | 三项建议已完成,维护者核查 Photo 与可用保存修订后按仓库规则手动 Merge | | ||
| | 已合入/核对基准阶段 | 已启用图文选择时核对所选基准处理结果;未启用时仍跳过自动更新 | | ||
| | 流程已完成 | 表示流程收尾,不改写原 Photo 差异或错误 | | ||
| | 被新版本替代/未合入关闭 | 前者查看新版本结果,后者不表示已合入或基准已更新 | | ||
|
|
||
| 推送新提交或 base 变化后重新核对版本并执行必要检查;旧结果不能证明新版本通过,新提交需要对应的有效批准。缺少摘要时先检查同仓、目标、创建时间、Draft范围,再联系维护者。 | ||
| 推送新提交或 base 变化后重新核对版本并执行必要检查;旧结果不能证明新版本通过,新提交须重新核对结果及可用的 Photo 保存修订。缺少摘要时先检查同仓、目标、创建时间、Draft范围,再联系维护者。 | ||
|
|
||
| ### 批准、合入和异常恢复 | ||
|
|
||
| 工作流识别具有仓库 Maintain/Admin 权限的维护者对**当前提交**作出的有效 GitHub Approve,该批准同时表示已人工核查 Photo。Bot 不自动 Approve/Merge;GitHub 分支保护和其他检查仍适用,工作流不新增强制 Checks 或修改仓库规则。 | ||
| 工作流中的 GitHub Approve 仅作审计;维护者核对当前提交的 CR、单测、Playwright 和 Photo 后,可以直接手动 Merge。GitHub 分支保护或仓库评审要求仍然适用,Bot 不会修改这些规则,也不会代为 Approve 或 Merge。 | ||
|
|
||
| Photo 自动差异评估及标准图自动更新暂停。Approve/Merge 不授权自动采用测试图;提前合入不会使未完成或失败的检查变为通过。新增/修改共享基准需管理员另行获得明确授权、人工核查并安排复验,原报告保留。 | ||
| 对已明确启用图文选择的 PR,BugServer 展示当前版本的图片和短说明,新候选默认全选。维护者应逐项核查;需要保留旧基准的项目取消选择,并在合入前保存成功。以服务端显示的保存修订为准,未保存草稿不生效;已保存的人工选择不会被默认全选覆盖。 | ||
|
|
||
| 合入后只更新该修订已选的基准,未选项不变。写入前仍核对冻结提交、三项检查、实际合入内容、保存时间及原基准;旧版本、合入后补选或冲突不能自动补认。请求超时或部分成功时联系维护者按原任务恢复,不重新派发或更换请求 ID。 | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. [P2] 区分启用图文选择后的基准更新与原有跳过状态 已启用选择且合入前成功保存选中项时,本段要求合入后更新这些基准;但同文件第 109 行的“已合入/核对基准阶段”仍说 report-only 下跳过自动基准更新是预期行为,英文版也一样。Photo 在新流程中仍为 report-only,因此维护者遇到选中项未更新时可能照状态表认定无需处理,错过本段要求的恢复。请把该行明确限定为未启用选择或清单不可用的 PR,并说明已保存选中项却未更新时需要核查或恢复。 已确认修复 (def407a): 原触发条件是启用选择、合入前已保存选中项,合入后更新却被跳过。当前中英文状态表均明确启用选择时须核对所选基准处理结果,跳过自动更新只适用于未启用选择;正文要求只更新已选项,无可用清单的人工处理边界也已明确,原来将遗漏误判为 report-only 正常跳过的矛盾消失。 |
||
|
|
||
| Photo 始终 report-only。没有可用选择清单(例如差异超过20项、解释未完成或执行错误)不新增合入门禁,也不自动更新基准。未启用图文选择的 PR 保持原模式。基准更新不会改写原 Photo 报告,流程 completed 不等于 Photo 全部通过。 | ||
|
|
||
| 请求帮助时提供 PR、当前 SHA、Review/CI 链接和可公开的错误说明。不要编辑 Bot 受管摘要或隐藏标记,不通过反复开关 PR、删除状态、换请求 ID 或另派批次绕过去重;由维护者回读和恢复原任务。结束时停止本次启动的测试服务、浏览器和子进程。 | ||
Uh oh!
There was an error while loading. Please reload this page.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
[P2] 同步更新仍将有效 Approve 写为必需的合入指引
当仓库规则本身不要求 Approve 且维护者已核查当前提交时,这里允许直接 Merge;但同文件第 108、113 行仍把有效批准写成进入“等待人工合入”及新提交的必要条件,英文版也保留相同说法。两种指引对同一场景相互冲突,维护者可能继续等待一个按新流程并非必要的批准。请将状态表和版本说明改为与可选 Approve 一致,并明确仓库规则要求批准时的例外。
已确认修复 (def407a): 原触发条件是仓库不强制 Approve 且维护者已核查当前提交。当前中文状态表已把等待合入定义为三项建议完成后按仓库规则手动 Merge,版本说明改为重新核对当前结果和保存修订;批准段明确 Approve 仅作审计且仓库规则仍适用。英文对应状态表与版本说明已同步,原先将有效 Approve 作为工作流必要条件的矛盾消失。