第一次用的人,能做出结果吗?
为什么这样整理
先别默认别人认识这些词
Ida 分享办公工具时提醒,很多同事连 Skill 是什么都不知道。这不是说谁理解力差,而是在提醒受众不同:你已经在聊 Agent、Skill、Token,对方可能还不知道它能帮自己做什么。[40]
“用得起来”本身就值得做
数读很早评价产品时,强调“他们真的可以用起来”;聊群知识库时,又说“要考虑大家都方便”。kyrie_H 则希望少一点反复更新群公告的麻烦。收藏了、安装了、看懂了、真的用上了,是四件不同的事。[2][32][33]
先让人看到下一步
先讲一个具体任务,再展示最短的使用路径,最后解释必要术语。比如额度究竟叫 Credit 还是 Token,也需要说准,否则不同计费方式会被误当成同一种东西。熟悉技术的人可以看架构,首次使用的人更需要知道怎样拿到第一份可用结果。[41]
没有证据说明全体群友都处于同样熟练度。网页也因此提供导览、深入阅读和原声三层,而不把所有内容一次堆给读者。
还可以继续问
一个不懂术语的人打开介绍后,能否知道接下来该做哪一步?
核对早期整理措辞
常被技术讨论漏掉的用户
Ida 分享办公工具时提醒:“对我们这种公司来说,很多人连 skill 是啥都不知道。”这不是理解能力评价,而是明确的受众边界:产品介绍若从 Agent、Skill、Token 开始,一部分读者尚未知道这些词与工作有什么关系。[40]
便利本身就是价值的一部分
数读很早评价一个产品时,强调的是“他们真的可以用起来”;讨论群知识库,又提出“要考虑大家都方便”。kyrie_H 希望减少反复更新群公告的成本。收藏到、安装好、看懂、用上,是不同阶段。[2][32][33]
给多数人的信息应该怎样组织
先展示可解决的具体任务,再给最低限度的使用路径,最后解释必要术语。额度叫 Credit 还是 Token 也不是小事:概念混淆会把不同计费方式误当成同一种资源。对复杂用户介绍架构,对首次使用者展示第一份可用结果。[41]