先听见用户看到的现象，给等待过程明确反馈，空结果也需要解释条件

先听见用户看到的现象

权限变化需要让内容拥有者理解实际影响。

状态说明需要覆盖结果暂时不明的情况。

给等待过程明确反馈

注释适合解释不能从代码直接看出的约束。某个看似多余的检查也许为了兼容旧文件，删掉之后才会暴露问题。把保留原因与可以移除的条件写在附近，能够帮助后来者作出判断，也比逐字复述下一行代码更容易在修改时提供实际价值。

产品文案应帮助使用者判断下一步动作。

页面简洁与信息可发现，需要放在一起考虑。

空结果也需要解释条件

命令行工具的退出状态应与文字提示一致。屏幕上写处理失败，退出状态却仍表示成功，会使自动化流程作出错误判断。可以为常见结果定义稳定约定，并把可读说明与机器可判断的状态分开维护，让人工操作与脚本调用都能准确理解本次执行的结论。

实现成功与使用者完成任务之间仍可能有距离。

不同长度的文字有助于检查布局是否稳妥。