技术笔记如果记录的是决策、约束和取舍,而不只是命令列表,通常会老化得更慢。命令会变化,但一个团队为什么选择某个方向,往往更长时间都有价值。

一个有用的结构

先说明问题,再写出约束,然后展示取舍,最后补上起作用的实现细节。这样的顺序让笔记即使在具体库或框架版本变化之后,仍然容易阅读。

1

123

让笔记保持精简

最好的个人知识库不应该变成另一份工作。一篇清楚记录一个决策的短笔记,通常比试图记住一切的大文档更有用。