外观
证据政策
本页结论:关键结论按证据等级分级管理;可靠性、事务与故障恢复结论必须有官方来源(E1),可实验的关键路径同时提供仓库内实验输出日志(E2)。
证据等级
| 等级 | 证据 | 可支持的内容 |
|---|---|---|
| E1 | 官方规范、官方文档、官方 Release Notes | 产品语义、配置、支持范围 |
| E2 | 仓库内固定版本可重复实验(demos/<产品>/<实验>/*.out.txt 输出日志) | 已观察行为、日志与状态变化 |
| E3 | 官方工程博客 / 设计文档 | 设计背景与实践建议,需注明上下文 |
| E4 | 第三方文章或个人经验 | 仅作补充,不支撑关键保证 |
使用规则
- 可靠性、事务、数据安全与故障恢复结论必须至少有 E1;可复现的关键路径同时提供 E2。
- 引用官方资料必须直接指向支撑该结论的页面,并记录核对日期(
checkedAt),见官方资料基线。 - 实验输出日志写入
demos/<产品>/<实验>/<角色>.out.txt,断言结果写入同目录assert.out.txt(逐条 PASS/FAIL);镜像版本以.env.versions锁定为准。 - 若官方行为与实验不一致:先标记问题与环境信息,不为了让测试通过而改写结论。
内容事实检查清单
写作与评审时逐条核对:
- [ ] 是否把营销描述改写成可验证的技术边界?
- [ ] 是否说明版本、配置和前置条件?
- [ ] 是否区分生产确认、Broker 持久化、消费确认和业务提交?
- [ ] 是否写明故障发生在哪个时间窗口?
- [ ] 是否区分原生功能、客户端功能、框架模式和业务代码?
- [ ] 是否有官方来源?可实验的结论是否有输出日志?
- [ ] 是否避免跨产品的错误同义词替换?
- [ ] 是否写明不保证什么?