栏目 02 · 手册编法与守则

谁在编这本手册,按什么收录,多久校一次

亿万28苹果把资料库当成一本要长期维护的手册来编,不追热点,也不做一次性推送。这一页把编法摊开讲:编辑怎么分工、条目怎么拿到编号、季度复核动过哪些地方,以及入口地址为什么一直没有换。

01

要的是能翻回来的说法

结论先放在前面:只有能被反复查、能对着版本比的说明,才值得收进来

一次性的通知适合推送,看完就沉下去。而用户隔了三个月再回来,找的往往是同一条说明有没有被改过、什么时候改的。所以站内内容不按发布时间排,按分类编号排——编号固定之后,一条说明换了措辞,位置还是原来那个。

如果你手上已经有一个具体问题,可以直接进帮助文档专区;想先看整体分类,从首页按分类一层层点下去也一样。

02

一条说明要过三双手

站内每一条说明都不是一个人写完就发。它至少经过三道不同职责的人手,各管一段,谁也不替谁签字。

  • 文档编辑与校对 11 人。把用户问出来的问题整理成可检索的条目,负责措辞、错字,以及这条该归到哪个分类编号下。
  • 技术支持 4 人。核对技术描述与网页版实际表现是否一致,尤其是服务清单的分类归属和各项权益的适用条件有没有写偏。
  • 内容审核 3 人。最后一道关,判断这条内容够不够格收进来,有没有超出可核对范围的承诺。

三组人不互相替代:校对管准确,技术管对不对得上,审核管该不该收。任何一组说不通过,这条就退回上一道,不会带病上线。

俯拍的工作台局部,摊开的校样纸上有铅笔圈注痕迹,旁边放着一支笔与一枚叶片形便签
校样上的圈注会被逐条带到下一版条目里,改动不留口头结论。
03

什么样的内容会拿到编号

一排按编号顺序排列的档案卡侧面特写,卡片边缘整齐,标签只露出编号区域

十二个一级分类,编号 A-01 到 A-12,位置固定不动。分类之下才是条目,条目拿的是分类号加序号。一条内容想拿到编号,得同时满足三条判断。

第 1 道

问题来源

来自帮助文档专区的检索记录与来信提问,优先处理反复出现的问法。

第 2 道

归类入册

按内容性质落到 A-01 至 A-12 中唯一的一个分类下,不做跨类重复挂靠。

第 3 道

写成条目

先给结论再给依据,写清适用条件和范围,超过三句的段落会被拆开。

第 4 道

编号发布

编号一经分配不再变更,后续修订沿用原号,改动记入版本节点。

反过来,下面这几类不会进手册:一次性的活动通知;没有明确适用范围的说法;必须登录才能看到的内容。它们不是不好,是不适合被反复查。

编号还有一条硬规矩:同一条说明修订之后,编号保留。改动不换新号,而是记在版本节点里——旧截图上的编号和现在的编号,指的还是同一件事。

04

季度复核,改动留痕

除了每月第 2 个工作日更新一轮,每季度还会把所有分类从头到尾复看一遍。这一轮不看增量,只看整体。

复核要回答三个问题:有没有该合并的条目、有没有该拆开的分类、有没有说明因为服务清单重排而找不到对应的位置。最近一次调整在 3 月底,动的主要是分类归属和部分条目的表述,一级分类的数量没有变化。

  • 改动本身不做“悄无声息”的处理——哪一条、哪一天动的,都挂在它的编号下面。
  • 复核产生的结论同样进入版本节点,不写成内部备忘就算完。
  • 如果某次复核什么也没改,也算一次结论,节点照记。

要回溯具体动过哪些分类,去资料库动态看版本节点,那里按时间顺序排着。

05

入口地址为什么一直没换

站点从起步到现在走过四个阶段,听起来像四个版本,其实只做了一件事:把说明安放到该在的位置上。

  1. 2019 年

    起步

    网站上线,先有分类,再有条目。内容的排列顺序就是编号的顺序。

  2. 其后一轮

    索引化

    把散落的说明按 A-01 至 A-12 归位,让每一条都能被一个编号找到,而不是靠翻页撞见。

  3. 2023 年

    专区化

    帮助文档专区上线,电脑端按类别重排服务清单,找起来比之前清楚。

  4. 2024 年

    重排与复核

    分类重排完成,季度复核固定成机制,一直运行到现在。

四个阶段里,域名和入口没有换过。原因很朴素:用户记的是一个地址,不是一个活动页面。地址一换,之前所有的引用就都断了。

老树干表面与新生枝条在同一画面中的局部特写,明暗对比清晰,无人物
主干不动,新枝从旧枝上长出来——索引扩展也是这样加上去的。
06

写清楚我们不做什么

可信度不是靠说得漂亮换来的,是靠边界划得清楚。下面这几条,我们会一直守着。

不写进手册的

  • 不承诺无法核对的服务时效。
  • 不在站外另开联系入口。
  • 不写“相关”“若干”这类没法验证的说法。
  • 不把通信地址说成已核验的总部、办公场所或注册地址。

写进手册的

  • 涉及数字的地方都把口径写全,能逐项对照。
  • 改动挂在分类编号下面,保留版本节点。
  • 每个索引区底部留一个纠错入口,反馈时带上编号和截图就够了。
  • 备案号豫ICP备27377931号长期在页脚公示。

这一页也属于手册的一部分。哪条编法说得不清楚,或者你在条目里发现对不上的地方,都可以走合作与联系指出来。