你的经验,大半死在聊天记录里了

我第三次回答同一个问题的时候,才意识到自己不是在帮忙。

那天有人问我:在服务器上改代码,备份应该放哪。我打了一遍。第二次被问,我又打了一遍。第三次,我把同样的话复制粘贴过去,然后停住了——这三遍回答,消耗的不只是我的时间,消耗的是这个团队里唯一一次能把这个知识点沉淀下来的机会。

聊天记录不会沉淀,它只会滚动。

重复回答是笔隐形成本,账记在回答的人身上

一个问题的标准答案如果是两百字,一天被问五次,一个月就是三万字。这个数字不吓人,真正贵的是另外两件事。

第一,每次回答的细节都不一样。 我第一次说「备份放网站根目录外面」,第二次说「别放在会被访问到的目录」,第三次补了一句「权限也要给对」。三句都对,但听的人拿到的是一份拼图。他拼错了、出了事,还得回来问我——成本翻倍。

第二,重复回答会制造一个假象:这件事只有你会。 团队里最有经验的人,往往最忙、最没空写文档,于是所有问题最终都汇到他这里。他以为自己在帮团队,其实把自己变成了单点故障。

一个团队的效率上限,很大程度上等于「有多少知识只存在于某几个人的脑子里」。这话有点狠,但你想想最近一次有人请假、整个流程卡住的那天,就知道它有多准。

大部分人做过知识库,然后它就死了

我不太信「建个知识库」这种说法,因为见过太多死掉的。死法基本就三种。

建在没人去的地方。 共享盘第四层目录、某个协作平台的子空间、一个没挂到导航上的页面。你想的是「我把知识放好了」,实际效果是「我把知识藏好了」。

写给人看的散文,不是给搜索用的条目。 六十页的《运维规范说明》,前二十页讲背景和原则。真出事的时候没人有空读,大家还是会去问那个老员工。

一次性工程。 三个月后系统改版、流程调整,文档还是旧的那份。一份过期的文档比没有文档更危险,因为它还带着「权威」的口气。

所以我后来给自己定了个很土的标准:这份东西,别人三十秒内能不能找到并且直接用。 找不到的,等于没写。

我的做法:不建库,只搬答案

流程很土,但一小时能起,而且真有人用。

第一步,只捞重复的。 翻最近两周的沟通记录,把被问过两次以上的问题,连同对方当时怎么问的那句话,原样抄下来。注意是抄他的原话,不是转写成你觉得规范的表述。

这一步最关键,因为它把「我觉得该写什么」换成了「别人真的在问什么」。大部分知识库在第一页就输了——写的是自己想说的,不是别人想搜的。

第二步,一条一问一答,标题用他会搜的那句话。 不写「文件管理与版本控制规范」,写「服务器上改代码,备份放哪」。前者是目录名,后者是搜索词。

第三步,第一行给结论,第二段再讲为什么。 先让人能干活,再让他服气。顺序反了,他读到第二段就走了。

第四步,挂到提问发生的地方。 这是最容易被忽略的一步。别指望别人改变习惯去找你的知识库,把答案挂在他提问的地方:群公告、项目根目录的说明文件、那个每天都被打开的表格旁边。你要去他的路上,而不是让他改道。

第五步,标一行「最后更新」和「谁负责」。 没署名的文档,半年后就没人敢信了。有署名,至少还知道该找谁核对。

一个真实的例子

我们服务器上有一条规矩:改代码前先备份,而且备份不能放在网站根目录下面——放在那里,理论上可以被浏览器直接访问到。

这条规矩被不同的人问过四五次。每次我都要从头解释一遍:为什么不能放,应该放哪,权限怎么设,改完什么时候能删。

后来它变成了一行:

备份放哪: 放 /root/backup/<日期>/,不要放网站目录下(会被直接访问到)。改完验证完再删,至少留三天。

从那以后,再被问起,我直接甩这一段,二十秒结束对话。

省下来的不是我的几十个字,是对方等我的那十分钟——以及他不敢动手的那段时间。人不敢动手的时候,不是在偷懒,是在等一个确定的答案。

观点:知识库不是文档工程,是搜索工程

我现在判断一份内部资料值不值得写,只问三个问题:

  • 别人会不会在三十秒内找到它?
  • 找到之后,第一行能不能让他直接动手?
  • 半年后它过期了,谁会第一个发现?

三个都过,才写。有一个不过,我宁可不写——因为一份没人用、或者已经悄悄过期的文档,占用的不是硬盘空间,是信任额度。

如果你的团队里也有那种「每次都得问某个人」的问题,今天就可以动手:把最近被问过第二遍的问题捞出来,写成一条。不用多,五条就够。

被问第二遍的那个问题,就是该被你搬出聊天框的东西。

留言板

0 条留言
还没有留言,沙发给你留着~ 有什么想说的,尽管敲在下面。

写点留言

正在回复

文明发言,友好交流。