文件整齐之外还需状态，让范围说明跟着选择变化，让危险操作说明影响对象

文件整齐之外还需状态

交互页面的简洁应与信息是否容易发现一起评估。

导出范围最好在操作发生之前清楚可见。

让范围说明跟着选择变化

命名争论可以回到读者需要辨认的差异。两个函数名称相近，却分别返回副本与修改原对象，就值得明确区分。相反，若行为完全一致，仅为了个人习惯增加新称呼，可能会制造额外学习负担。名称的价值在于帮助预测用途，而不只是符合作者偏好。

一个功能的效果应放在具体使用流程中检查。

批量行为的影响不能仅靠当前屏幕让人猜测。

让危险操作说明影响对象

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

帮助内容应围绕任务，而不是只列页面上的控件。

中途离开后如何恢复，也是流程完整性的一部分。