项目结束后,最容易留下的是代码,最容易消失的是当时的约束。几个月后再看一个看似奇怪的实现,如果缺少背景,很容易把必要的折中误判成设计失误。
我想记录什么
工程笔记至少应该回答三个问题:当时遇到了什么,尝试过哪些方案,为什么最后选择了现在这个实现。
结果当然重要,但失败过的路径同样有价值。它们能帮助未来的自己避免重复验证,也能让团队讨论建立在证据上。
这个博客就是这样一份长期笔记。技术文章会尽量给出可以复现的上下文,生活记录则保留那些不适合写进项目文档、却同样影响判断的思考。
把项目经验写下来,不是为了制造结论,而是保留当时做出选择的上下文。
项目结束后,最容易留下的是代码,最容易消失的是当时的约束。几个月后再看一个看似奇怪的实现,如果缺少背景,很容易把必要的折中误判成设计失误。
工程笔记至少应该回答三个问题:当时遇到了什么,尝试过哪些方案,为什么最后选择了现在这个实现。
结果当然重要,但失败过的路径同样有价值。它们能帮助未来的自己避免重复验证,也能让团队讨论建立在证据上。
这个博客就是这样一份长期笔记。技术文章会尽量给出可以复现的上下文,生活记录则保留那些不适合写进项目文档、却同样影响判断的思考。