按主题分组,负责选题判断、步骤撰写与分类索引的日常维护。
2019 年,我们把内容做成了一张索引表
展签 01 / 起点最早的时候,站上没有那么多玩法说明,也没有成体系的帮助文档。为了让读者不必逐个页面翻找,编辑把每个主题的入口手写进一张索引表,按类别排好,谁需要什么就顺着这张表往下点。
内容越长越密之后,这张表塞不下了。2021 年,分类索引正式上线,索引变成了可以按主题、版本、设备类型和问题类型四种方式筛选的目录。第一次来的人,也能在三次点击内找到方向。
到了 2024 年,我们做了同页对照改版:玩法说明与帮助文档不再各占一页,而是并排放在同一阅读流里。读玩法时若遇到操作疑问,右手边就是对应的帮助条目,不用后退,也不必重新搜索一遍。
- 2019 开始整理玩法内容,建立第一版主题索引表
- 2021 分类索引上线,支持主题、版本、设备与问题四类筛选
- 2024 完成同页对照改版,说明与帮助并排阅读
一道说明要过四道工序
展签 02 / 流程一篇说明从无到有,要经过选题、撰写、对照复核、发布四个环节。选题看的是读者这周真正在问什么;撰写要求把动作拆到可以照做的粒度;对照复核由版本校对和主题编辑背靠背核对;最后一步才对外发布。四个环节都有人负责签字确认。
帮助文档的写法更偏向操作:平均每篇包含 5–8 个操作步骤和 3 个常见误区提示。我们不假设读者已经知道上一步的结果,每一步都会写清判断依据——点完之后屏幕上应该出现什么,没出现又该回到哪里检查。
-
01
选题
从读者支持团队整理的高频问题里挑,优先补那些反复出现、又缺少完整步骤的主题。
-
02
撰写
按操作顺序逐条写,每一步给出现象和判断依据,避免"视情况而定"这类让人无从下手的表述。
-
03
对照复核
版本校对对照当前版本逐条比对,术语统一由校对组把关,确认没有指向旧版本的说法残留。
-
04
发布
发布时同步归入分类索引,并在帮助文档侧挂上对应的玩法说明入口,让两边随时可以互相跳转。
一篇说明读得顺,是因为有人先替读者卡过一次壳。
编辑手记
12 个主题,260 篇内容
展签 03 / 规模内容库目前设 12 个一级分类、46 个二级标签,收录 186 篇玩法说明与 74 篇帮助文档。分类不是越多越好——每多一层目录就多一次点击;二级标签的存在,是为了让第一次来的人也能用具体的问题类型把范围缩到一屏之内。
玩法说明负责讲清一条内容怎么玩、规则是什么、在哪里看;帮助文档负责讲遇到问题怎么办、按什么顺序查。两者互相挂接,读的人不必先判断自己该看哪一类。
版本一路走到 v2.3
展签 04 / 版本早期版本里,排查说明、通道切换与反馈入口分散在不同页面。读者遇到问题时往往要来回跳转,跳着跳着就忘了自己查到了哪一步。从那时起,我们把每次版本更新当成一次整理机会:先让同类问题归拢到同一页,再让操作入口跟着说明一起出现。
本季度发布的 v2.3,重点补充了客户端登录异常与正式版下载异常的排查说明,并在排查段落下方固定通道切换与反馈入口。遇到问题的人不必先记住路径,顺着当前页面就能走完自查与反馈。
-
早期版本
说明与帮助分开存放
玩法说明与帮助文档各自成页,排查一个问题要在两三个页面之间来回切换,路径依赖个人记忆。
-
v1.x 阶段
分类索引接管入口
主题、版本、设备与问题四类筛选方式建立,查找动作从"记住路径"变成"按条件缩小范围"。
-
v2.0 前后
登录与下载按场景分组
登录异常与下载异常从混杂的条目里拆出来,按发生场景重新组织,排查顺序第一次被明确写进正文。
-
v2.3
排查说明补全,入口归位
登录、下载与通道切换的排查步骤同步更新,通道切换与反馈入口固定在排查说明下方,自查完就能直接反馈。
14 个人,按主题分头维护
展签 05 / 团队编辑团队由 9 名内容编辑、3 名版本校对和 2 名读者支持人员组成。内容编辑按主题分组,每人固定负责若干分类,熟悉自己那几块内容的来龙去脉;版本校对负责术语统一与版本比对;读者支持人员把一周内出现频率最高的问题整理出来,交给编辑补充进说明里。
术语统一是一块容易被忽略的活。同样的动作在不同分类里曾经有好几种叫法,读者看完一条换个页面又要重新理解。校对组依据统一的术语表逐条比对,把同一件事收敛成一个说法。
逐条对照当前版本,负责术语统一与新旧版本之间的差异比对。
整理高频问题与反馈线索,把真实使用场景带回到编辑流程里。
每周 2–3 篇,每月一次整体复核
展签 06 / 节奏内容库的更新节奏比较固定:每周完成 2–3 篇说明更新,每月做一次分类索引复核。遇到版本迭代,相关分类会集中过一遍,确认没有指向旧说明的入口遗漏在外。
设备同步是另一块持续投入。桌面、平板与手机三端阅读时,分类索引会保留最近浏览位置;换一台设备接着读,不用重新搜索。这条体验看似不起眼,却是换设备后继续查阅最常被用到的功能。
- 每周 2–3 篇说明更新
- 每月 1 次分类索引复核
- 版本迭代时集中校对相关分类
- 三端保留最近浏览位置
- 反馈工作日 24 小时内给进度
查得到、接得上、说得清
展签 07 / 结果把内容长期整理下来,最后落到三件事上:查得到——按主题、版本、设备类型或问题类型缩小范围,比盲目搜索更快;接得上——换设备后继续上次的位置,不必从头翻起;说得清——遇到问题时,能对着说明里的步骤给客服描述现象,而不是只说"打不开"。
查得到
四类筛选方式配合 46 个二级标签,把范围压到一屏之内,新手也能顺着点下去。
接得上
换设备继续读同一篇,最近浏览位置随分类索引一起带过去。
说得清
排查步骤给出可对照的现象描述,反馈时附上设备型号、版本号与页面路径,沟通成本更低。