起点
从一张对照表开始
2019 年刚起步的时候,我们手上只有一张表。左列是设备,右列是同一件事在不同设备上的入口位置,同事拿着它一边点一边改。表格后来长成了 42 篇操作说明,覆盖登录、切换、下载与查询四类动作;配套的网页端工具清单整理出 18 项,按用途分成登录类 5 项、设备切换类 4 项、资料下载类 5 项、查询类 4 项。
说明里用到的配图一共 96 张,其中设备对照图 26 张、步骤分解图 40 张、界面示意图 30 张。它们大多画的是同一件事:您现在在哪一屏,下一步点哪里。
2023 年做了一次调整,把工具清单和新版页面切换说明放到了同一页。理由很直接——多数人是在找入口的时候,才发现自己不清楚该用哪个工具,在两个页面之间来回跳,只会让人更急。
三个节点
-
2019
一张设备对照表起步,先解决“入口在哪一屏”。
-
2023
工具清单与切换说明并到同一页,减少来回找。
-
2024
顶部大菜单换成紧凑命令栏加侧边索引,长文更好找章节。
团队
谁在维护这些资料
12 个人,三组分工,每组盯的都是同一件事:您照着做的时候会不会卡住。
-
内容编辑 5 人
从读者问得最多的问题里挑选题、写初稿,把技术同事的答复改写成能顺着做下去的句子。
-
技术支持 4 人
在真实的电脑、平板和手机上把每一步点一遍,处理反馈里提到的入口打不开、页面不对版。
-
设计与前端 3 人
画对照图与步骤分解图,维持第2版说明的版式、编号和标注,让关键动作在图上先被看见。
流程
一份资料的五道工序
一条说明从被提出来到摆到您面前,中间会经过下面五步。每一步都有人在设备上真的走过。
-
01
选题,先挑问得多的
问答库现有 68 条记录,登录与入口相关 31 条、资料下载 18 条、工具使用 12 条,其余 7 条属于其他情况。哪一组问得密,就先写哪一组。
这一步还做了什么
一篇说明至少要能解决一整类问题才动笔,少见的一次性情况先记进问答库,等情况重复出现再单独成篇。
-
02
实机走一遍
在电脑、平板、手机上各点一次。电脑端写得最细,另外两端只写与电脑不一样的地方,避免同一段话重复三遍。
这一步还做了什么
界面上的按钮叫什么,文字里就写什么,不换成自造的近义词,读者一眼就能对上屏幕上的字。
-
03
另一位同事独立再走一遍
他只看文字、不看截图,卡住的地方就是需要改的地方;改完由第一位同事回看,确认没有改出新问题。
这一步还做了什么
两人的判断不一致时,由技术支持组当场在设备上重做一次,按实际能走通的那条路径定稿。
-
04
标清版本
每条说明都标明属于第2版还是存档内容。第1版的旧说明留在更新动态里可查,方便还在用旧页面的读者。
这一步还做了什么
版本标签放在标题下方,切到旧页面的人一眼能看到自己读的不是当前内容,不用读完整篇才发现。
-
05
发布后接着跟
发布只是开始。资料每月更新 8–12 条,每季度把全部内容完整过一遍,跟着页面改版同步调整。
这一步还做了什么
反馈里指出的错误直接排进下一轮更新;入口打不开这类紧急情况当天处理,不等排期。
覆盖与响应
很多人和我们遇到同一类问题
访问我们的用户分布在 34 个省级行政区,其中华东与华南合计约占四成。区域不同,卡住的地方却相当接近。
把鼠标停在任意一行上,可以看到对应区域的说明。
出问题的时候
- 受理时段
- 工作日 9:00–18:00
- 首次回复
- 平均 6 小时内
- 复杂问题
- 2 个工作日内给出进展
入口打不开、页面和说明对不上,都可以直接说,附上您用的设备与浏览器会更快定位。
提交一个问题回访
每年一次的读者回访
我们每年会请读者讲一次使用感受。最近一轮收到 1,240 份有效反馈,其中约七成与资料定位有关,其余是入口异常和操作疑问。根据这些意见,我们合并了 6 篇内容重复的条目,重绘了 22 张步骤图。
“步骤图里的箭头指得太细,手机上看不清。”这条反馈让我们把全部步骤图的线宽重新画过一遍,也把编号从图上挪到了图旁。
—— 来自上一轮回访的意见,已并入第2版配图调整
第2版发布后,我们新增 9 篇说明。六个版本周期走下来,操作步骤基本都换过一次配图,页面改版快的阶段,更新也跟着密一些。