如果人们找不到那一页,那一页上的字从来就不重要

写得多没有用,找得到才算交付;可发现性是文档的第一质量。页浏览量生命体征留给衡量簇;本篇只认「找不到 = 没写过」。

Baklib Avatar

  浏览:0

Baklib

1. 金句:找不到 = 没写过

访谈把交付标准说得很硬:如果人们找不到那一页,那一页上的字从来就不重要;你必须拆成有用的块,好让人能找到他们在找的东西。
交付定义从「写完」改成「找得到」。找不到的字,对组织等于库存报废——仓储成本付了,客户侧仍像没货。作者觉得交付了,因为稿子过了审核、挂上了站;用户觉得你们没写,因为搜不到、点不到、链不到。两边各说各的「有没有文档」,吵的其实是可发现性,不是字数。写完却找不到,组织付了两次成本:写作的,和继续被人问的。
国内客服现场更直白。帮助中心里其实有「如何导出报表」,标题还起得挺正经,可惜挂在「高级功能 → 数据管理 → 其他」第三层;站内搜索打「导出」,先冒出来的是一篇 2023 年的活动说明。于是客服打开收藏夹里的飞书文档,或者翻企微「导出-新」聊天记录,把正确步骤再打一遍。字在,交付不算完成。人累,口径还在继续分叉——群里最新口述、帮助中心旧文、销售方案里的截图,三套说法,开会对齐又要半小时。
可发现性是文档第一质量。文案漂不漂亮,是后一阶问题;先问有没有门、门上有没有灯、灯下是不是现行事实。过期的入口比没有入口更伤——用户以为走进了正式通道,读到的却是过期事实。空着的叶子,有时候不如暂时不开。
伙伴开发者想对接接口,也常撞同一堵墙:官网产品页很漂亮,文档站里关键页挂在冷门栏目,站内搜索先冒出营销案例。联调多耗两周,事后复盘写成「文档要重视」——其实要重视的是找得到,不是再多写两万字。找不到 = 没写过。这句话听起来狠,执行起来却很土:先让别人打得开、搜得到、链得稳,字才开始重要。

2. 可发现性已经是团队感知最强的 AI 收益

公开观察里,认为 AI 让文档更好的人中,对「找信息更快」的感知很强;对话式能力与 AI 增强搜索也已有可观部署。收益首先落在「找到」,不是「写得更美」。团队若把预算全砸在润色语气,却不投导航、标签、检索与稳定深链,等于把字藏进地窖再抱怨没人读。AI 在这里首先是到达工具,不是润色工具——先帮人落到对的块,再谈句子漂不漂亮。
AI 智能搜索——白话是全文检索再加总结一层到达——它帮人落到对的块,不替你们发明结构。没有分类与稳定 URL,搜索只能在噪声里更勤奋:标题不像用户会搜的句子,命中的往往是碰巧相似的旧文;标签与版本缺失,过滤无从下手。搜索再强,也像在迷宫里喊话。你以为上了「智能」,其实只是把「不确定在哪一页」自动化成了「不确定该信哪一句」。
站点地图 与清晰导航,则是给爬虫和人同时留的门牌:栏目怎么挂、哪些页对外、深链是否稳定。门牌乱,再强的检索也救不了「不确定在哪一页」的焦虑。用户抱怨「你们文档太少」,真实痛点常常是「不确定在哪」——字不够多,是假痛点;找不到,是真痛点。
国内团队还有一种错觉:以为上了搜索框,可发现性就自动达标。搜索框只是扩音器;标题不像搜索词、分类像档案室、元数据空着,扩音器只会把噪声喊得更响。本篇不谈把页浏览量当唯一生命体征——那是衡量簇的事。这里只认可发现性本身:不确定在哪一页,是真实痛点;字不够多,常常是假痛点。先让找得到,再谈写得漂不漂亮、读不读得下去。找不到,漂亮也等于没写过。

3. 拆块是为了找,不是为了显得勤快

为拆而拆会难维护,目录会变成碎玻璃:一百个半页 FAQ,标题彼此撞车,版本互相对不上。为任务、为 FAQ、为可检索标题而拆,才是为了找。用户真实痛点常常是「不确定在哪一页」,不是「你们字不够多」。拆块是在降低不确定:一页一事、标题像搜索词、前提写在页内。不确定降下来,人和助手才落得到对的块。拆,是治理动作,不是勤奋表演——表演给周报看的拆页,往往下周就维护不动。
元数据(产品、版本、角色、内容类型)让过滤成为可能;分类体系管理 让导航不是随手文件夹——栏目按用户任务排,而不是按你们内部部门排。没有这两层,拆块只会制造更多找不到的碎片。分类若不以用户任务为主轴,标准化再喊口号也落不了地——规矩必须落在对外看得见的树上,而不是落在某次会议纪要里。
国内可执行的小实验:让没读过站的同事只靠搜索与导航完成「导出报表」「重置权限」两件事。卡在哪一层,就改哪一层的标题、分类或元数据——先别急着再写第三篇长文。标题要像用户会搜的句子,不像内部项目代号;分类要让人三步内点到,不像档案室;元数据要让过滤有意义,不像贴完就忘的标签墙。还有稳定深链:今天还能打开的帮助页,下周改成另一个 URL、旧链 404,对实施群与客户收藏夹等于「字蒸发了」。找得到,包括此刻找得到,也包括下周还能用同一条链接找得到。可发现性不是一次性装修,是持续维护的门牌。
再补一条很土的检查:把站内搜索关掉,只留导航,看高风险任务能不能三步内点到;再把导航折起来,只留搜索,看同一任务能不能靠标题与元数据命中现行页。两路都走不通,说明树和到达都没立住;只通一路,说明另一路还在欠账。拆块、改标题、补元数据,往往比再开写一篇「完全指南」更接近交付。

4. Baklib:结构 + 搜索,对着「不确定在哪一页」

Baklib 对着的是「不确定在哪」,不是「再多写两万字」。目录、标签、AI 智能搜索,先让人落到对的块;帮助中心 与 Wiki 知识库 是主战场。结构是树,搜索是到达——两样都要,缺一不可。只有树没有搜索,人要自己爬;只有搜索没有树,命中的是噪声。建设侧先点亮 Help、Docs 一类骨干叶子时,优先把入口、分类与可检索标题立住,再谈花果与活动页。
落地顺序可以对着成熟度尺子做人话版:先看帮助、文档这类触点在不在、找不找得到,不急着评价文案写得漂不漂亮。很多团队一上来就想做漂亮站、堆活动页,骨干入口却是空的或过期的。先让「有门、找得到」变成别人可以打开浏览器验证的状态,字才开始重要。验收也可以很土:关掉润色讨论,让不熟产品的同事只靠站内导航与搜索走完五个真实任务——走不通的地方,就是可发现性还没立住的地方。
站点地图、分类与元数据,是门牌工程;AI 智能搜索是到达层。门牌乱,到达层只会更快地把人带到错页。帮助中心与 Wiki 可以分工:一个偏任务自助,一个偏口径与规格——但两边都要让人找得到现行页,而不是各藏各的「比较新」的材料。少堆无关的热闹入口,多修骨干触点:有门、找得到、链得稳,比再开一个漂亮首页更值钱。
对负责人更刺耳的一句是:文档预算若还按「写够字数」批,可发现性却按「搜索框有没有」批,两边会对不上。字数够、找不到,仍然等于没交付;搜索框有、标题乱,仍然等于没门牌。先把门牌工程立进周会:本周改了哪些标题、补了哪些元数据、修了哪些深链——比本周又写了多少字,更接近「找得到」的交付定义。
找不到 = 没写过。写完却找不到,组织付了两次成本:写作的,和继续被人问的。先让找得到,字才开始重要;找不到,再勤也像没写。门牌先亮,库存才算货。

产品能力

相关词典

Baklib Birds
to top icon