1. 金句:不要关在自己房间
访谈里有人说得很直:我们不会把自己关在单独的房间里;确保技术写作者与产品团队充分融合非常重要。
关在自己房间里,文档会变成「发完版再补的附件」。嵌进产品信息流,文档才有机会跟着变更走:默认值改了、权限前提变了、例外出现了——作者看得到,才谈得上写得进对外库。看不见变更,只能写过期说明书;写得再漂亮,也是把旧世界誊抄得更整齐。誊抄得越整齐,客户越容易相信那是现网——伤害也就越大。
编制解释不了质量:人多也可能各写各的网盘;人少但嵌进发版节奏,反而能守住骨干页。隔绝解释得了落后:消息进不来,发布再勤奋也只是把旧世界写漂亮。融合不是「天天开会」。融合是文档职能出现在发版清单、出现在试用卡点复盘、出现在客服 Top 问题周报里。出现在信息流里,变更才进得来;只出现在编制表上,变更仍在门外。门外的人再努力,也只能写门外听来的传闻。
本篇不写贡献路径细节。这里只钉一件事:位置错了,工具再好也像在隔壁房间装修。装修可以很美,住进来的仍是过期事实。
2. 没团队更难上 AI,但人数不是质量
公开观察里,没有正式文档团队的组织并不少;其中一项 AI 功能都没上的比例更高。集中式编制仍常见,但嵌入才是同步和质量的条件。没团队更难上 AI,往往不是缺模型,是缺人把真源收拢、缺人点发布。模型可以租;发布权与真源住所,租不来。租来的模型若读的是群附件,只会更快地传播分叉。
人数不是质量。三人关在房间里,也可能三个月对不齐现网;一人嵌进产品频道,也可能把发版说明和帮助任务对上号。质量来自信息是否进得来、放行是否有人、对外是否找得到——不是来自工位是否贴着「文档组」门牌。门牌可以后贴;信息流不能后补。后补信息流的代价,是客户已经按旧步骤做完了不可逆操作。
国内很常见:文档是兼职,发在飞书,对外找不到。兼职可以,阵地不能缺。兼职若仍关在「写完丢群文件」的房间里,客户浏览器里仍然没有稳定入口。兼职若嵌进发版与帮助发布,一人也能守住骨干叶子。没有正式团队时,更要先有对外真源和内外权限:谁能改草稿、谁能点对外发布、对内协作与对外帮助是否分开。工具不能替代负责人,但能让负责人立刻有阵地。有阵地,兼职也像职能;没阵地,全职也像临时工。
3. 国内:文档是兼职,发在飞书对外找不到
上午发版,下午群里口述「新默认值是多少」;帮助中心仍停在上个月。文档同事不在发版频道里,或在频道里但没有可发布系统——两种都叫关在房间外的另一种房间:信息流在,阵地不在。信息流解决「听得到」;阵地解决「发得出」。只解决一半,客户仍然打开不到。
内容孤岛 在组织形态上也很具体:产品一套飞书、支持一套企微、市场一套网盘,文档组若再独自一套,就变成第四个孤岛。说人话,不是缺文章,是缺一份大家认账的真源。嵌进产品,不是取消文档职能,是让变更进同一处真源,再内容复用到该亮的门口——一处维护,多门口到达。多门口若各养各的货,融合会变成更大的分叉联盟。
云内容管理 说人话,是协作与发布发生在可权限、可版本的地方,而不是个人桌面与群附件。关在房间里的常见结局,是「最终版」永远在别人电脑上。打开浏览器对外找不到,等于没发布。先有能发布的系统,再谈编制扩编。顺序反了,加人只是多几个在孤岛之间传文件的人;顺序对了,小团队也能先亮帮助与文档入口,再谈热闹叶子。
现场还有一种「看起来融合、其实仍隔绝」:文档同事天天进产品会,会后材料仍散落在个人桌面;对外站没有稳定入口,客户只能问群。融合要落到可发布系统与可打开入口,才叫拆房间;只落到日历邀请,房间还在,只是门上贴了「欢迎参观」。参观解决不了发版后的默认值同步。
把一周拆开看,隔绝通常长这样。周一发版评审,文档席位空着,或只旁听不记动作;周二默认值已变,群里口述三遍;周三帮助仍旧;周四实施按旧步骤失败;周五复盘写成「下次文档要重视」。重视若仍等于加班补页,房间没拆,只是加班灯亮了。拆房间的最小动作更土:发版清单固定一列文档入口与负责人,变更进可权限的协作库,对外发布有人签字,浏览器能打开同一份事实。
拆房间还有一个很土的验收:发版当天,对外帮助能否指出新默认值所在页。指不出,说明文档职能仍在门外——哪怕人坐在会议室里。坐在会议室里不等于嵌进信息流;嵌进信息流,是变更进得了可权限的库,放行有人签字,浏览器对外找得到。
小团队最怕「等招齐人再开始」。等的结果通常是:飞书继续当对外真源,客户继续问群。先有 Wiki 与内部知识分享中心这类可权限阵地,兼职也能守骨干;守住之后,再谈编制扩编与 AI 功能。内容孤岛不会因为多开几次会自动消失;内容复用也不会因为口号自动发生。云内容管理说人话,就是别让最终版住在别人电脑上。
嵌入还可以用反例说明。文档组人很齐,周会很准时,却从不出现在发版清单;产品改默认值只在研发频道同步;帮助更新靠「有空再说」。这叫编制齐全的隔绝。反过来,一人兼职,却固定出现在发版清单与客服 Top 问题回流里,并能在 Wiki 与内部知识分享中心改完、放行、对外点亮——这叫编制单薄的嵌入。质量跟的是信息与阵地,不是头衔。
内容孤岛在组织房间之间同样成立:每人一套最终版,对外找不到共同真源。内容复用要求变更进一处再分发;云内容管理要求协作发生在可权限处。Baklib 先给阵地,再谈编制——顺序反了,加人只是多几个传文件的人。不会把自己关在单独的房间里,落地就是:出现在发版清单,守住可发布系统,让浏览器对外找得到。
4. Baklib:先有能发布的系统,再谈编制
Baklib 侧,小团队也能先有对外真源和内外权限;工具不能替代负责人,但能让负责人立刻有阵地。
Wiki 知识库 与 内部知识分享中心 一类场景,让协作发生在可权限的地方:对内可讨论,对外另有发布面。文档嵌进产品信息流,不等于取消作者;嵌进是为了变更进得来,作者是为了放行仍有人签字。别人打开浏览器能验证帮助与文档入口还活着,融合才算做成;验证不了,再融洽的站会也只是关在更大的房间里开会。
先有能发布的系统,再谈编制扩编;先有内外权限分界,再谈谁全职谁兼职。系统与权限把「房子」立住,融合才有落点。不会把自己关在单独的房间里——金句很软,落地很硬:出现在发版清单里,守住可发布阵地,让对外入口找得到。编制可以后加;隔绝要先拆。