如何用金字塔思维来写技术笔记

之前写笔记也有意识的遵循一些规范/套路，比如WWW（What-是什么问题，When-什么情况发生，Why-为什么会这样），但都是些零碎，不成系统的经验之谈；

偶然了解到《金字塔原理》，和当初第一次阅读《高效能认识的七个习惯》一样的感觉，相见恨晚！
金字塔思维里阐述的表达技巧有别于文学创作，更注重的是信息传播的效率，以最少的语言，最简洁的形式让读者get到作者想表达的内容，写技术笔记真是再适合不过了；

本文主要记录如何运用金字塔思维来写技术笔记，持续更新写笔记的方法论。

注意一篇文章关注解决1个问题

什么是金字塔思维？

金字塔原理的基本结构是：

• 结论先行，以上统下，归类分组，逻辑递进；
• 先重要后次要，先总结后具体，先框架后细节，先结论后原因，先结果后过程，先论点后论据；

搭建金字塔结构的具体做法是：

• 自上而下表达，自下而上思考，纵向总结概括，横向归类分组；
• 序言讲故事，标题提炼思想精华；

怎么思考问题？

自下而上思考，先发散再收缩，找到核心问题；

纵向总结概括

问题界定

找到方向/核心问题/中心思想的步骤：

• 出现了什么问题？
• 期望结果是什么？
• 非期望结果是什么？

横向分类归组

演绎推理法

方式一

• 阐述世界上已存在的某种情况。
• 阐述世界上同时存在的相关情况。
• 说明这两种情况同时存在时隐含的意义。

方式二

• 出现的问题或存在的现象；
• 产生问题的根源、原因；
• 解决问题的方案；

归纳推理法

• 将具有共同点的事实、思想或观点归类分组，并概括其共同性（或论点）
• 同组中的思想具有类似的主语或谓语。

怎么表达问题？

自上而下表达，结论先行

• 表达一般需回答最常有的4类疑问：

  • 是什么？
  • 为什么？
  • 如何做？
  • 好不好？

• 表达时重点突出、条理清晰，让人愿意看、看得懂、记得住，行文要思路清晰、言简意赅。

如何写序言？

序言4要素

1. 介绍背景（S, Situation）
2. 指出冲突（C, Complication）
3. 引发疑问（Q, Question）
4. 给出答案（A, Answer）

序言回答的4类问题

1. 我们应该做什么？
2. 我们应该如何做（将如何做/是如何做的）？
3. 我们是否应该这样做？
4. 为什么会发生这种情况？

怎么解决问题？

记哪些笔记？

• 记录踩坑过程
• 分析技术原理
• 总结效能工具

怎么写笔记？

序言

• 是什么？问题说明，背景示例
• 为什么？介绍问题产生的背景/原因，目前存在的冲突

正文

• 如何做？分析问题的解决方案
  • 当前方案的实现细节
    • 类图
    • 代码解读
    • 流程图
  • 其他可选方案
• 好不好？评价解决方案
  • 优缺点
  • 适应场景
  • 使用案例

术语/附录

参考

• 博文链接
• 书籍名称

参考

• 《金字塔思维-芭芭拉.明托》