先有说明书,后有官网
第一批上线的是客户端下载和版本说明,页面结构按「找到版本 → 看清问题 → 照着做」排,没有太多别的东西。
牛宝主站 2016 年上线,第一批放出来的不是宣传页,是一份版本说明和一张问题清单。九年下来,稳定版 v3.2 还在按批次维护,移动端设备对照清单持续补入新机型,一群写文档、接电话、校版本的人守在这条线上,把回访用户遇到的麻烦一条条拆开写。
02 — 起点
2016 年刚上线时,团队手上没有现成的帮助中心,只有客服邮箱里堆着的提问。装不上的、打不开的、导不出的,一条条抄下来,按问的人多不多排个先后。
这份清单后来成了所有文档的底稿。问得最多的排在最前,回答尽量写成能照着做的步骤,不绕弯子。今天帮助文档里的 260 余条编号条目,源头就是那几张写满字的纸。
写文档的人和接工单的人坐得不远。一个问题刚在电话里讲完,下午就可能变成一条新条目。
03 — 年份刻度
第一批上线的是客户端下载和版本说明,页面结构按「找到版本 → 看清问题 → 照着做」排,没有太多别的东西。
移动端有了独立入口,机型差异一下浮出水面。团队把零散反馈归了类,建起第一版设备适配库,从此按机型记录,而不是按印象。
帮助文档启用四位编号,技术支持和内容编辑之间的交接从此靠编号说话,不用再把上下文复述一遍。
设备对照清单改成每季度补一次机型,今天覆盖 6 个常见品牌、42 款机型与 3 类系统版本区间,旧机型也能查到。
稳定版 v3.2 走长期维护节奏,累计发布 18 次维护更新,最近一轮集中在导出模块。回访用户的旧工程不用急着换。
焕新版 v4.0 启动速度比稳定版提升约 35%,界面与导航结构重做过。旧设备开之前,先对着清单确认一遍系统版本和屏幕尺寸。
04 — 团队
团队不算大,分工倒清楚:写文档的、接问题的、校版本的,各管一段,但都盯着同一批编号。点开下面三栏,能看见每班人平时在忙什么。
12 位内容编辑每天翻客服记录,挑出重复出现的问题,写成一条只讲一件事的短条目。每月修订 20 至 30 条帮助文档,旧措辞过时了就重写,不做无限追加。
18 位技术支持守着邮箱和电话,工作日平均 2 小时给出首次回应。接起来先分环境、格式、缓存、日志四类,再对照编号把对应的排查顺序发过去。
6 位版本校对负责最后一道关。每两周把版本索引校一遍,每年春秋两季各做一次全量设备适配复核,新机型进来先在这里过手。
05 — 一条文档的旅程
内容编辑按工单写初稿,先定四位编号,再决定挂进 12 个栏目里的哪一栏。
技术支持拿着稿子在一台真实设备上照做一遍,走不通就退回重写。
发布后同步更新版本索引,旧条目里指向失效的,一并改掉。
每两周校一次索引,用户反馈说没解决,条目重新拆开处理。
一条文档至少要过两双手:写的人负责说清楚,复核的人负责确认照着做能走通。走不通就不发。
06 — 覆盖
服务从太原发出,靠远程跑。东北的设备冬天启动慢,南方的老机器卡在系统版本上,同样的客户端在不同地方表现不一样,这些差异最后都变成了文档里的判断条件。
每年春秋两季,团队会做一次全量设备适配复核。换季前后系统更新多,旧机型最容易出状况,提前校一遍能省下不少来回。
07 — 协作
移动端导航异常的高频原因集中在三类:系统手势设置、屏幕缩放比例、旧缓存残留。这类问题靠猜没用,得拿着具体机型在现场跑一遍。牛宝主站与 12 家设备服务商、8 家系统集成商保持适配协作,现场反馈直接进文档。
现场遇到的机型表现带回来,整理成设备清单里的新行。
新系统上线前先拿设备清单,把不兼容的机型提前圈出来。
覆盖 6 个常见品牌、3 类系统版本区间,按季度补新机型。
08 — 做法
不写大而全的说明书,把每个现象单独拆成一条。用户搜到哪一条,照着做就行。
四位编号配 12 个栏目分类,搜编号或搜现象关键词,都能落到同一条上。
版本号、设备参数、栏目编号用统一写法,翻到哪一处,看到的都是同一句话。