所有文档的主要目的，是去掉用户与产品之间的摩擦

所有文档的主要目的，是帮助用户使用产品；与之绑定的，是帮助发现并购买。归根结底，就是去掉用户与产品之间的摩擦。

堆页面的诱惑来自好度量：页数、字数、更新条数都好看。去摩擦的度量更土：卡点是否减少、重复来电是否下降、发版后「变了什么」是否可核。好看的度量若排挤土的度量，文档会越写越勤，用户越用越卡。

页面可以很多，摩擦也可以很多：找不到、信不过、步骤与现网打架、发版了却不知道变了什么。字数不是 KPI；卡住的那一步被拿掉，才是交付。本篇不写产品内嵌趋势长论——那是后文；这里只钉去摩擦。

把去摩擦写进周会目标时，下周排期才会优先补可发现入口与现行步骤，而不是优先堆软文库存。字数好看解决不了卡点；卡点消失了，用户体验管理才会在「用起来」这一层真正落地——体验不是口号，是少卡一次。勤奋写了很多页，若高流量任务仍卡在第三层目录，勤奋只是看起来很勤奋。

去摩擦若写成周目标，排期会老实很多：先补卡住的那一步，再谈文笔。写反了，库存页数好看，卡点还在原地。

入职摩擦还会传导到客户成功：内部新人若自己都找不着现行说明，对外培训与实施交付会把同一套不确定复制给客户。内部先去摩擦，外部自助才有原料。

功能半隐身还有一种国内变体：发版海报很炫，帮助搜索仍命中旧名。用户按新名搜不到，按旧名找到过期步骤，摩擦叠成愤怒。发现与变更说明，必须跟版，不能只跟海报。

行业公开观察里，文档对入职、对功能发现的影响面已经很大——只是很少被这样记账。

新人第一周不是在学「你们文笔好」，是在学「这份东西以哪份为准」、按钮在哪、权限怎么开。功能上了线，若没有一页能打开的说明，等于功能对用户半隐身。文档已经在做「让人用起来」。账本若仍只记客服成本，就会系统性地低估它——入职人天与功能发现失败，往往记在别的科目里。

摩擦的反面不是「页很多」，是「卡点少」。新人入职第一周、功能刚上线那几天，文档其实已经在扛发现与上手。把去摩擦写进目标，排期才会优先补可发现入口与现行步骤，而不是优先堆软文库存。对买家而言，这同样是客户旅程里从「听说」到「用起来」的那段路——旅程不断在广告，常常断在「找不到那一步」。

国内产品团队常见的错位是：发版会开得很热闹，帮助中心与手册仍停在上一大版本；销售群里口头说「已经支持」，客户自己点开帮助却搜不到。摩擦不是文笔问题，是发版与说明不同步——卡在「变了什么没人写清」。功能上了线却半隐身，等于研发成本付了，体验层没收货。

入职场景里还有更土的摩擦：新人同时收到飞书「入职包」、企微「必读」、帮助中心旧教程三份材料，第一周学会的不是产品，是「以哪份为准」。功能发现同理——发布会说了新能力，站内搜不到现行页，能力等于半隐身。文档若在扛入职与发现，账本就该承认它在扛；只记客服成本，会系统性地把「让人用起来」写成费用外的运气。

文笔优化可以排在卡点之后。卡点清单上的「找不到 / 过期 / 版本不清」，每一条都比修辞更优先。修辞解决的是好不好读；这三条解决的是能不能做完。

国内现场里，摩擦很少是「比喻不够生动」。更常是：帮助中心第三层才有真教程；站内搜索被旧活动压过；更新只在企微刷屏，正式页还是上季截图。用户停住、问人、或放弃——不是他读不懂比喻，是他不确定哪一版对。

不确定感，才是真实痛点——和「等车太久」背后其实是「不知道车到哪了」同一类：要的是可核对，不只是更多字。加长一篇过期教程，不会减少摩擦；下架旧文、标清版本、让现行页可分享，才会。文笔可以后磨；过期入口比没有入口更伤——用户以为走进正式通道，读到的却是过期事实。

客户自助服务要成立，前提是现行步骤找得到、做完能自证成功。否则自助只是把「问客服」推迟成「先猜半小时再问」。去摩擦的交付标准，可以很土：卡点清单上的那一步，今天能不能少一次来电、少一次微信补发。列得出卡点，才排得出优先级；列不出卡点，排期就会退回「再写几篇」。

过期与找不到，还会叠出第三种摩擦：用户找到了旧文，按旧文做失败，再来电时带着愤怒——不是「我不会」，是「你们文档害我」。过期入口比没有入口更伤，因为它消耗了信任额度。去摩擦若只加新页、不下架旧页，卡点清单会越补越长；减法有时比加法更接近本职。

手册、日志、帮助三片叶子若各改各的，用户仍会卡在「变了什么」与「此刻怎么做」之间。发版周把三片一起点亮，去摩擦才完整；只改其中一片，卡点会从这一扇门溜到另一扇。

帮助中心接住买前与用中的同一套问题；产品操作手册讲清怎么用；产品日志讲清变了什么。建设侧可点亮 Help、Docs、Feedback。问答若开，只综合已发布页，对着「卡住的那一步」，而不是再堆一篇万字总览。手册负责深度，日志负责变更可见，帮助负责此刻怎么做完——三片叶子，对着同一类卡点，比再开一个热闹站点更接近本职。

落地顺序：先列高流量卡点（入职、导出、权限、发版后变更），再保证每条卡点有稳定入口与现行说明；字数与美化往后排。发版周同步改日志与帮助，比事后补软文便宜。去摩擦，是文档的本职。堆页面，只是有时看起来很勤奋。把目标从字数改成卡点，排期才会老实——用户要的不是你们写了很多，是他少卡一次。

产品经理验收功能时，可加一条：现行帮助/日志是否可打开。功能完成却说明不可达，等于摩擦预定在发版当天。

再补一句可验收的底线：卡点清单是否进周会；发版周是否同步改日志与帮助；过期页是否有下架或标注。三件做到，去摩擦才像本职；只堆新页不下架旧页，摩擦会在搜索结果里继续增生。少卡一次，比多写一篇更接近交付。

卡点清单应进产品与客服的共同周会，而不是只进文档团队周会——摩擦是跨角色的，去摩擦也必须跨角色。