把零散笔记整理成可复用的知识系统
零散通常发生在哪里
目录齐全，并不意味着阅读路线清晰。同一主题可能同时出现在原理、工具指南和实践中，读者却不知道应先看哪篇、哪些内容重复、哪个示例可以直接验证。
整理时先回答“这篇文章帮读者完成什么”，再决定它放在哪里。
按文章要解决的问题归类
| 内容类型 | 核心问题 | 应留下的结果 |
|---|---|---|
| 知识库 | 为什么这样工作？ | 原理、边界与关联概念 |
| 开发指南 | 这项技术怎样使用？ | 前置条件、关键用法与查阅入口 |
| 开发实践 | 一个具体问题怎样处理？ | 复现步骤、方案、验证与代价 |
| 算法 | 怎样推导并验证解法？ | 思路、复杂度、边界样例 |
| 项目 | 多个技术点怎样协作？ | 运行入口、流程、设计决定与结果 |
| 博客 | 有什么值得记录的观察？ | 事实来源、个人解释与待确认问题 |
一篇实践文章只需简述必要原理，再链接回知识库。遇到内容重叠时，先比较两篇的目标；目标相同才考虑合并，不因标题相似就删除。
一篇文章的最小结构
# 一个具体问题
## 场景与前置条件
描述读者遇到的现象、环境，以及已有知识。
## 最小示例
给出输入、步骤和预期输出。
## 为什么这样做
解释关键决定，以及没有采用其他方案的原因。
## 如何验证
给出可重复的检查和至少一个失败或边界样例。
## 适用边界与关联阅读
说明不适用的情况，链接前置知识与后续实践。
不是每篇都必须照抄标题，但应能找到这些信息。引用外部结论时记录来源；依赖工具版本的示例写明实际验证版本，未运行的示例明确标注。
一个整理例子
假设有三篇缓存笔记，分别介绍缓存原理、工具命令和业务更新流程。可以把“为什么要缓存、失效意味着什么”留在知识库；命令与配置放进指南；更新失败如何复现、怎样检查数据状态放进实践。
三篇互相链接，并在阅读入口说明“原理 → 工具 → 具体场景”的顺序。这样既能按路线学习，也能在遇到问题时直接查到对应层次。
每次只完成一个主题闭环
挑一个近期真正用到的主题，找出已有文章，补前置链接、一个可验证示例和一个失败边界。然后从首页走到文章，点击链接，再用正文关键词搜索，检查读者是否找得到、看得懂、用得上。