给异常状态留下继续的办法
用户应能分辨内容已接收与结果已完成的不同阶段。
页面简洁与信息可发现，需要放在一起考虑。
文件整齐之外还需状态
接口文档中的示例应当说明约束，不能取代约束本身。一个合法响应只展示了许多可能状态中的一种，调用者仍需要知道字段缺失与空值的含义。把规则与示例放在一起，有助于减少各方根据单个样例自行推导，从而形成不兼容的处理习惯。
产品文案应帮助使用者判断下一步动作。
重复点击可能来自反馈不足，而非使用者缺乏耐心。
文案应帮助用户完成下一步
本地开发环境说明应记录必要条件，而不是复制作者机器上的全部路径。绝对位置、个人账户与临时设置往往无法通用。可以把可替换参数与必须固定的版本分开，并用新的环境验证关键步骤，让接手者知道哪些内容需要按自身情况调整，减少照抄之后才发现差异的成本。
状态说明需要覆盖结果暂时不明的情况。
错误提示应解释当前影响，并提供合适的下一步。