个人技术博客的内容整理方式
很多问题解决后很快就忘了,过几个月再遇到还要重新查。写技术博客对我来说不是为了追求长篇文章,而是把当时的环境、判断和处理过程留下来。
记录什么
一篇笔记至少包含四部分:问题现象、环境信息、排查过程和最终结论。代码片段和命令行输出可以少量保留,但重点是说明为什么这样处理。
如何命名
标题尽量直接描述问题,比如“接口超时排查”比“某次线上事故复盘”更容易检索。标签也保持少而稳定,方便以后按主题回看。
很多问题解决后很快就忘了,过几个月再遇到还要重新查。写技术博客对我来说不是为了追求长篇文章,而是把当时的环境、判断和处理过程留下来。
一篇笔记至少包含四部分:问题现象、环境信息、排查过程和最终结论。代码片段和命令行输出可以少量保留,但重点是说明为什么这样处理。
标题尽量直接描述问题,比如“接口超时排查”比“某次线上事故复盘”更容易检索。标签也保持少而稳定,方便以后按主题回看。