上周老张被叫去给城东新搬进来的机房做巡检，刚进门就被主管拉住：‘你那本网络维护手册呢？新来的实习生得照着学。’老张一愣——他平时记在备忘录里的重启口令、光纤插错位置的排查步骤、交换机端口灯不亮时先看哪几项，还真没系统整理过。
别从目录开始，先从‘救火记录’里挖
很多同事一提写手册就想列大纲、分章节，结果写了三天还在‘第一章 总则’打转。不如翻翻自己最近三个月的运维日志：哪次半夜接到电话说视频会议断流？哪台接入交换机反复掉线？哪次误拔了核心链路但两分钟内恢复？这些真实场景就是手册最硬的骨架。
比如某次发现办公区Wi-Fi突然大面积掉线，查下来是AC控制器内存溢出自动重启。你顺手记下的操作步骤：
1. 登录AC Web界面（地址：https://192.168.5.1）
2. 进入【系统管理】→【日志查询】，筛选关键词“reboot”
3. 查到异常时间点后，执行命令：system restart memory-clear
4. 重启后观察AP上线状态，用ping -t 192.168.10.1测试网关稳定性图要带箭头，命令要带报错截图
文字描述‘检查网线是否松动’不如贴一张工位照片：网线插在电脑后USB接口旁那个蓝色RJ45口上，旁边红圈标出‘此处易误插为USB扩展坞’；写‘查看ARP表’不如直接贴终端截图，把arp -a输出里那行异常的00-11-22-aa-bb-cc（对应离线打印机MAC）用黄底高亮出来。
我们机房墙上就贴着一张A4纸：《光模块故障速判三步》——左边是SFP指示灯常灭/快闪/慢闪的三种状态照片，中间画了对应的光纤跳线弯折半径示意图（≤3cm），右边一行字：‘若收光值<-22dBm，优先换对端模块，非本端光衰’。新人扫一眼就能动手。
留白比填满更重要
手册里专门设了‘待验证’栏目，比如：‘华为S5735-L交换机开启LLDP后，部分旧款IP电话无法获取VLAN ID（已知兼容型号：CP-8865，不兼容：CP-7821）’。不写解决方案，只写现象+设备型号+复现条件。等下个月测试完新固件再补结论——留白不是偷懒，是让手册活得下去。
最后提醒一句：别存成PDF锁死。我们用的是Git私有仓库，每次修改都提交备注，比如‘20240412-补充H3C MSR36路由器console口波特率默认值由9600改为115200’。谁改的、为什么改、改前啥样，全在历史里。手册不是文物，是每天都在呼吸的工具。