站长圈隐秘真相：技术文档工程师十年拆解

　　去年12月份那台Dell R740的文档拆解，我原以为跟往常一样，拆到电源模块就能收工——结果卡在背板走线上了。旁边老陈叼着烟，说“这线序文档里没标全吧？”我翻出PDF，发现第三页的线号从12直接跳到15，中间那三根在图里画得跟麻花似的。车间那台风扇一直在响，我摘了手套擦汗，结果手套上一块硬掉的胶蹭到主板上，吓得我当场掏酒精棉——这活儿，真不是光看文档就能搞定的。

　　站长圈那篇“十年拆解”的文章，我倒觉得“优胜劣汰”那点说得挺准。去年帮某云厂商写存储阵列文档，对方技术总监直接甩了句“别写太细，怕被友商抄”。我愣了——不写细，用户怎么修？他冷笑：“能修的早被挖走了，剩下的都是看文档按步骤操作的。”后来发现，确实，那些能拆到底的工程师，文档里连螺丝扭矩都标得明明白白；而那些“差不多就行”的，文档里全是“适当调整”“视情况而定”——这不就是淘汰机制在起作用？

　　不过话说回来，有些老型号的文档，真不是“优胜”就能解决的。比如那台HP DL380 G7，我拆了五年，每次遇到风扇控制板，都得翻出2012年的原始文档——因为2015年后的版本全删了这部分，说是“过时技术”。结果呢？上周还有个客户因为风扇不转，拿着2012年的文档来找我，说“你们文档里写的步骤，新版本里没了”。我翻出旧版，发现步骤里有个“短接J12”，新版本里连J12的引脚定义都没了——这算优胜劣汰，还是自断后路？

文章配图，仅供参考

　　其实我也没拆到底。那台Dell R740的背板走线，我最后是照着实物反推的文档——因为原文档里的线序，跟实物对不上。我敢打包票，这文档在初版时肯定没经过实机验证。中午盒饭里有块姜，我挑出来扔在桌上，老陈说“挑食活该饿肚子”，我回他“这姜太老，咬不动”。他笑了，说“当年我拆第一台服务器，连螺丝都分不清公制英制，现在不也成了老师傅？”

　　说到老师傅，我想起老张。他去年退休前，把那本《HP ProLiant维护手册》传给我，说“这书我写了十年，改了二十版，现在看，还是有很多错。”我翻开，发现扉页上写着“2008年3月，初稿”，最后一页的修改记录停在“2018年12月，第20版”。老张说“有些错误，我明知道存在，但改不了——因为厂家不提供新资料。”我合上书，突然明白，为什么站长圈那篇文章里说“技术文档工程师的宿命，是被厂家和用户夹在中间”——改不了，写不全，还得背锅。

　　修完那台R740，我自己都没底。背板走线我反推的文档，虽然能装回去，但不确定是不是最优解。客户问“这线序有没有标准？”，我支支吾吾说“按实物走的，应该没问题”。他走后，老陈说“怕啥？真出问题，就说是厂家设计问题。”我摇头——这锅，文档工程师背不起，也甩不掉。谁把扳手掉地上了一声闷响，我抬头，发现是小李，他正蹲在另一台服务器前，皱眉看主板。

　　这个型号我只在别人那儿见过——Dell R940，四路至强，背板走线比R740复杂三倍。我问他“拆这干啥？”，他说“客户说文档里的步骤不对，装不回去。”我凑过去看，发现文档里写着“先装CPU1，再装CPU2”，但实物上，CPU2的插槽被散热片挡着，必须先装CPU2才能装CPU1。我笑了——这文档，怕不是写文档的人没拆过实物？

　　这个我说不准，要看运气。有些文档，写得再细，也架不住硬件版本更新快；有些文档，写得再糙，只要硬件没变，就能凑合用。站长圈那篇文章说“技术文档工程师的十年，是跟硬件和厂家斗智斗勇的十年”，我挺认同——但更认同的，是那句“最后活下来的，都是能在这夹缝里找到平衡点的”。

　　下午客户来取机器，我递过文档，说“背板走线部分我反推的，可能跟原厂有出入。”他翻了两页，点头说“比原厂文档清楚。”我愣了——原来，用户要的不是“标准”，是“能用”。至于优胜劣汰？管他呢，先把今天的活儿干完再说。

（编辑：应用网_常德站长网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!