一份记录,不是一个频道
我做网络工程十五年,Cisco、Juniper、Aruba 的生产网都跑过。这里记录我把退役企业设备拆开、看懂、装上开源系统的过程。
这里写什么
每台设备一条记录,固定七段:它是什么、拆开看到什么、买之前要知道什么、完整操作步骤、哪些能用哪些不能用、值不值得、以及我还没解决的部分。
顺序是固定的,因为它就是我实际调查一台设备的顺序。最后一段永远存在——如果一条记录没有"还没解决的部分",通常说明我测得不够细。
这里不写什么
不写"应该可以"。没有亲手验证的内容会明确标注为未核实,或者干脆留空等填。引用别人的工作会写清出处,不会把 PR 里的步骤当成自己的实测结果。
也不写教程式的成功学。失败记录和已知限制是这里最有价值的部分,因为它们最省别人的时间,而且这类内容抄不来。
方案集锦同理:每条方案都必须写清在什么环境验证过、以及什么情况下它不成立。这两项留空的话构建会直接失败。
为什么是"档案"
档案和频道不一样。频道要求更新节奏,一停就衰减;档案是累积的,停三个月也不掉价,靠搜索被找到而不是靠推送。
这个区别对我很重要:它意味着我可以按硬件本身有趣的程度选设备,而不是按题材的热度。
← 回到档案索引