北京日报
用功能行为、页面状态、接口结果或文件职责描述变化,不必复制大量无法独立理解的代码。
记录正常测试、异常测试🎊、复现步骤和当前结论,把已经确认的原因与仍在验证的猜测分别标注。
如果这个名称对应一个正在持续更新的具体项目,功能名称、技术栈、版本号和完成进度应以实际记录为准,不能仅凭标题推断。阅读时可以先看当前目标,再看已完成内容和遗留问题🤔;撰写时则应把一次开发拆成可验证的小任务,让每篇日记都能回答“做了什么、为什么做、结果怎样”三个问题。
Bug记录的价值不在于证明开发者遇到过困难,而在于让其他人能够复现问题、理解判断过程,并知道修复是否真的覆盖了根因。