从电玩厅的一张牌桌做起

2016 年之前，我们大多数人做的都是同一件事——守场子。换筹码、讲规则、处理机器上的小毛病，一天下来要回答同样的问题几十遍。后来想，与其一遍遍说，不如写下来。

1. 2016 把台面上的规矩写成文字

   问的人太多，回答就成了重复劳动。我们把最常被问到的部分整理成文字发出去，从规则、计分到设备准备，第一份资料就是这么攒出来的。同年开始按版本给客户端文件归档，老机器也能一直找到能用的那一版。

2. 2019 从电脑端走到平板

   平板上操作跟键鼠是两套习惯，字更小、按钮位置也不一样。我们把界面操作拆成一节节配图说明，改到自己不看注释也能照着做出来为止。手册从那时候起开始带截图。

3. 2021 文档编辑拆成单独一组

   之前是大家轮流写，同一个功能在这份文档里叫一个名字，换一份又变了，读者看得难受。这一年把文档编辑单独拆出来，专门做版本差异比对和术语统一，指南里的每一步都要有人在真机上先跑一遍。

4. 2023 下载位置和对局检索固定下来

   客户端、手册、常见问题各自有了固定位置，玩家不用再在聊天记录里翻文件。对局回放检索也在这段时间上线，按时间、房间、牌局类型三种方式都能翻到最近的对局记录。

5. 至今 3.x 系列与老设备分支并行

   平板客户端进入 3.x 系列，目前累计发布 18 个正式版本；2.x 分支继续维护，给还在用老设备的玩家留着一条路。每一版的改动要点都会记下来，方便对照自己手上的版本。

三块合起来是一条完整的链路——有人发现变化，有人验证变化，有人把变化写成你看得懂的话。人手不算多，但每一块都有固定的人盯着，不会出现“这个没人管”的情况。

客户端什么时候更新不由我们说了算，但资料什么时候跟上是可以安排的。下面这几件事有固定的节拍，不靠临时想起来。

• 随版本发布 手册和道具说明跟着客户端一起修订。道具说明目前覆盖 46 种道具，按计分辅助、外观装饰、房间增益、社交互动四类整理，版本改了哪一项会同步标出来。
• 每月一次 常用入口对照表按月同步，把高频入口的位置变化更新进去，常按的几个功能尽量不出现在“找不到”的名单里。
• 每年一次 指南类内容整体校订一遍，换掉过期截图和失效步骤。校订完会把变动要点记进更新记录，你手上的旧文档对不对得上，看一眼就知道。
• 长期在线 对局回放检索保留最近 90 天的记录，段位查询的入口也一直开着，不用等谁上线帮你查。回看某一场的细节，随时都能翻出来。

每个季度做了什么、改了什么，都按阶段记在动态与版本里，想确认自己那版处在什么阶段，从那里看最快。

有一部分内容我们单独写不出来。赛季阶段怎么打、某些道具在实战里到底好不好用，这些得听长期在一线的人讲。所以专题内容一直是和供稿的内容合作方一起做的：他们出玩法和经验，我们负责把术语、格式和版本对应关系拉齐，最后合成一份能直接照着看的文档。

按赛季阶段组织起来的跨版本专题目前有 12 个，其中最长的一个从第一期做到现在，已经连续更新了 14 期。专题的每一期都会标明适用的版本范围，读者不用自己去猜这份内容是不是还管用。

内部审一份文档的时候，我们主要看下面这五条。你能用这五条来判断我们做得好不好，也能用它们来判断别处的说明是不是靠得住。

1. 01

   版本对得上

   文档开头先写清楚对应哪个客户端版本。版本不同、按钮位置不一样的地方，直接注明差在哪，而不是含糊带过。

2. 02

   每一步能在真机上走通

   写指南的人自己按步骤装一遍、点一遍。哪儿卡住了，要么改写法，要么补一张图，绝不留一句“照提示操作即可”。

3. 03

   同一个功能只有一个叫法

   手册、道具说明、常见问题里出现的是同一个名字。术语不统一，读者就会以为说的是两回事，白绕一圈。

4. 04

   出错时知道先看哪一步

   不写成一路顺畅的说明书。装不上、连不上、找不到入口该怎么排查，都单独列出来，遇上问题的当下就能用。

5. 05

   后面一直有人接着管

   不再维护的内容会明确标出来，同时指给你替代的那一份，避免你照着早就过期的说明折腾半天。