docs(refactor): [DOC-07] improve sequencing and release gates

This commit is contained in:
Harvey Zhao committed 2026-09-10 18:08:40 +08:00
1 parent d7b348f3a6
commit 1fa0a57831
14 files changed
+386 -99

No files matched your search

+6
View File
@@ -19,6 +19,7 @@
3. 不使用整个 minified bundle 的文本相等作为 API 兼容证据。
4. 已确认缺陷使用单独用例记录“旧版本复现,候选修复”;差分例外必须有变更记录,不能一键更新全部快照掩盖回归。
5. 接口、类型与行为三项分别验收。只有类型检查通过不能证明运行时正确。
6. 起步先验证核心与试点,各包迁移前补齐自身发布基线。历史失败、候选回归和缺少环境分开,执行 ENG-10 的失败台账及逐模块门槛,不以全仓库初始全绿作为启动条件。
## 核心测试清单
@@ -33,6 +34,7 @@
- [ ] 热键、焦点、document 重绑、全局监听器及组件清理。
- [ ] i18n、图标、主题、样式注入及用户 CSS 覆盖。
- [ ] 每个内置插件:autoPlayback、autoOrientation、fastForward、lock、miniProgressBar。
- [ ] 键盘可达性、可访问名称、设置菜单焦点、模式退出后的焦点返回和字幕可用性;保留原快捷键与自定义 DOM/CSS 用法。
此清单是验收目录;具体任务状态仍只记入 tasks.json。
@@ -53,6 +55,10 @@
快速检查必须存在依赖映射;无法确定受影响范围时运行完整核心及生态检查,不仅按文件名选择测试。
ENG-02 先交付仓库内可执行的 CI 配置;GitHub required checks 的实际设置属于外部状态,在发布准入时核实,不能把没有仓库管理权限变成本地测试框架建设的前置阻塞。尚未迁移的包保留历史失败台账,迁移包严格验收,所有受影响公开路径的候选回归仍阻止交付。
不要在媒体测试中靠固定 sleep 等待。优先受控事件/状态条件、固定样本和故障注入;对重试、偶发失败及 trace 有明确记录。真实设备缺失不阻止无关文档/本地候选准备,但始终阻止缺证据的相关能力通过发布验收。
## 证据要求
每次记录命令、HEAD、运行时与浏览器版本、样本、通过/失败/跳过数、报告路径和限制。报告持久化到可追溯的 CI artifact 或仓库中适量文本摘要,不只给开发机器临时路径。不提交大型录像/媒体/trace 到源码仓库。