关于
一个人,一个文本编辑器,一堆没整理完的 markdown。
这个站是什么
是一个个人笔记站。我平时做后端相关的工作,遇到问题会先把排查过程记下来, 过一段时间再回头看,往往能发现自己当时的判断哪里错了。这些记录就放在这里。
内容全部是自己动手之后写的,没有翻译,也没有把别人的文章剪贴过来。 所以更新很慢——一个月一两篇,取决于这段时间有没有遇到值得记的事。
写什么
主要是四类:编程语言与工具、网络与协议、系统与运维、以及一些效率上的小技巧。 共同点是「查过、试过、踩过」,最后留下一个我能照着复现的步骤。
不写什么
不写新闻、不做评测、不推荐产品。这类内容保质期太短,也不适合放在个人笔记里。 另外,涉及具体公司内部系统的内容一律不写,哪怕是脱敏的。
关于错误
笔记里的结论都是当时环境下的结论,换了版本可能就不成立。 如果你照着做发现不对,那大概率是我写得太绝对了,欢迎来信指出,我会在原文里更正并注明。
这个站是怎么维护的
纯静态页面:一个 HTML 就是一篇,样式全站共用一个 CSS 文件,没有框架、没有构建步骤、没有数据库。 好处是五年后打开还是这个样子,不会因为依赖升级就整站崩掉;坏处是加新东西都得自己手写。
写之前会先在本地或服务器上把命令跑一遍,把真实的输出抄进正文。 涉及版本的地方会注明在哪个版本上验证过——因为很多结论换个大版本就不成立了。
写东西的几个习惯
- 先记现象,再记结论。现象是「谁看到什么报错」,结论可能会过时,现象不会。
- 命令写全路径和参数,不写「修改相应配置」这种话。
- 能给出判断依据的,就给出判断依据,比如「怎么确认是缺中间证书」而不只是「重签一次」。
- 不确定的地方标出来,不硬凑结论。
更新记录
联系
邮件是最靠谱的方式,我一般两三天内回。 不接广告,不接受付费写稿,也不做技术咨询——不是清高,是精力有限。