把资料保存进知识库很容易,困难的是下次打开时仍然知道它能解决什么问题。与其先设计一套庞大的目录,不如从一条笔记开始,检查它离开原来的上下文后还能不能被理解。
标题写成可以回答的问题
“阅读资料整理”是一个范围,“怎样区分摘录与自己的判断”则是一个问题。后者能帮助写作者决定哪些材料应该留下,也能让回访者在打开之前判断是否相关。
这里所说的独立理解不翻找聊天记录,也能知道笔记在讨论什么。,不是要求一条笔记包含所有背景,而是补齐必要的对象、场景和结论。遇到相邻问题时,用链接连接,不必把整段内容重复复制过来。
一条笔记的最小结构
问题: 怎样让项目记录在几周后仍然看得懂?
回答: 在操作步骤前写清触发问题的场景,在步骤后留下可观察的结果。
例子: 将“调整导航”改成“读者无法从分类页找到旧文,因此统一分类名称,并重新检查五篇文章的入口”。
边界: 这适用于小范围维护;跨项目决策还需要记录参与者、备选方案和约束。
链接需要说明关系
“相关笔记”下面堆十个标题,读者仍然不知道为什么要点开。更好的写法是先说明关系:这条笔记提供背景,那条笔记记录反例,另一条则是实际使用的方法。
比如,“系统化整理”讨论对象、关系和边界,本篇把其中的边界落实到单条笔记。这个关系可以写在正文里,再给出入口。
系统化整理允许笔记重新拆分
写到一半发现其实有两个问题,并不代表开头选错了。先完成其中一个,再把另一个移到新页面,保留一句连接说明。每次整理只解决眼前的混乱,结构会随着使用逐渐清楚。
回访时可以做一个很小的检查:只读标题和第一段,能否说出这条笔记的用途?如果还不能,优先补写这两处,再考虑增加更多标签。