花 150 欧元请真人试读安装说明 一位开发者修文档的方法

开发者圈子有句老话：读不懂说明书就别用。一位英国开发者却看到了这句话的反面——很多时候，根本不存在一份能读的说明书。他给自己写的开源工具做了一次罕见的实验：花钱请真实用户来读安装说明，一小时 25 欧元，前后一共花掉大约 150 欧元，换来一份被真人逐句挑过刺的文档。整件事听起来不复杂，做到的人却很少。

实验的方法很朴素：他在社交平台上发出招募，凑到几位愿意参与的读者，然后逐一视频通话。规则只有一条——共享屏幕，并把自己在做的每一步大声说出来：哪里看不懂、哪里被卡住、哪里觉得惊喜、哪里感到恼火。他在旁边手写记录，几个小时里听完了一整套关于自己错误假设的清单。每测完一个人，他就改一版说明，再交给下一位继续测。

被挑出来的问题大多是开发者想不到的：示例工具的链接是错的；有人只在终端里读说明；重命名文件这四个字到底指什么；隐藏文件又该怎么重命名；哪些内容必须加引号而哪些不用；玩笑话不仅不好笑，还会让人困惑；术语没有解释；章节顺序让人迷路；文档压根没讲清楚这个软件是做什么的。这些问题单拎出来都很小，叠在一起就是用户流失的全部理由。

有人会问：为什么不直接让 AI 模拟几类用户来测试？他的回答很直接——他要的是真人。真人会笑，会认真较劲，会有完全意外的视角，视频里猫还会乱入；更重要的是，他能从对方的声音里听到那种挫败感，而挫败感恰恰是判断这处必须改最可靠的信号。他写技术文档的那几年里，同事给他当第二双眼睛的经验也是同理。这些细节里有判断力，也有诚意。

这套方法对独立开发者尤其划算。花一百多欧元，买到的是最贵的用户反馈：他们打开产品的第一小时里到底发生了什么。文档、注册流程、上架页、引导页，任何要递给用户阅读的环节都可以做一次出声测试，从三五个人开始就有效；迭代的方式也不必复杂——改一版，测一人，再改一版。比起憋一个完美版本再发布，这种小步试读的性价比高出太多。

更值得琢磨的是这个实验的立场：他把文档当成产品的一部分，而不是写完代码之后的苦差事。工具会过时，代码会重写，但让第一次接触的人顺利走通这件事，是产品和用户之间第一层信任。愿意为它花 150 欧元的人，省下的是无数用户在深夜放弃你的那一刻。对做工具、做服务的人来说，这大概是回报率最高的一种认真。认真对待第一次见面，这句话对产品同样成立。

创业找资源，上乌鸦部落。