将用户无法独自回答的事情转化为一份 问卷:一份 Markdown 文档,用户交给某个人异步填写,或在会议中一起填写。接收者掌握用户缺乏的知识;问卷要把这些知识引出。
追问发送,而不是主题。 只就 _发送_ 采访用户,这始终可以回答:发送给谁,以及他们需要什么回复。文档中的问题随后针对接收者知道什么与用户需要什么之间的 差距。
- 这是要发送给谁的? 在一次交互中询问接收者的角色、专业知识和与用户的关系。这确定问卷的语气以及必须承载多少上下文。当你知道接收者是谁,以及他们知道哪些用户不知道的内容时,完成。
- 你需要什么回复? 在一次交互中询问用户无法独自解决、需要从这个人获得的具体决策或事实。当你得到一份具体清单,说明用户必须离开时能够做什么或决定什么,完成。
- 编写问卷。 遵循下面的文档结构,起草针对步骤 1–2 中差距的问题。将其写入当前目录中的
to-questionnaire-<slug>.md(slug 来自主题)并报告路径。当文件存在且用户在步骤 2 中列出的每一项都被某个问题覆盖时,完成。
文档结构
将文档定位为 发现式问卷:用户缺少上下文,接收者掌握它。按重要性从高到低排列问题,因为异步意味着你可能只能获得一次回答机会;当问题超过少数几个时,按主题将它们分组到 ## 标题下。使用下面的模板编写。
<questionnaire-template>
<Questionnaire title>
目的: 说明这份问卷为何存在,以及它关系到什么决策。
来自: <the user>,致: <the recipient>,你的答案将如何使用: <where they go>
上下文
用一段话为不在用户脑中的接收者提供方向。足够答好,但不是一页纸。
如何回答
截止日期和大致的投入。部分回答和“我不知道”都有用:标记任何你不确定的内容,而不是跳过它。
<Theme heading>
每个主题一个 ## 部分。在每个部分下,列出其问题,按重要性从高到低排列。每个问题只包含一个想法,绝不复合,正下方留下一个答案占位,只有一行 _为什么这很重要_,且仅在问题可能被误读或可能招致敷衍回答时使用。
<question-example>
系统在发布时预计要处理多大的负载?
_为什么这很重要:它决定我们现在为突发流量进行资源准备,还是推迟。_
</question-example>
还有别的吗?
一个收尾的兜底问题:我们没问但应该知道的内容有什么?
</questionnaire-template>