让历史记录能够回答问题
帮助内容应围绕任务,而不是只列页面上的控件。
对不确定状态的诚实说明,比虚假的进度更可靠。
同样名称应有稳定的行为
帮助检索中的词汇应包含用户可能使用的日常说法。内部称为归档的动作,有人可能会搜索隐藏或收起来。可以在解释中建立这些称呼的关系,并明确相似动作的差别,让文档帮助概念对齐,而不是要求读者先猜中产品团队选定的术语才有机会找到答案。
导出范围最好在操作发生之前清楚可见。
交互页面的简洁应与信息是否容易发现一起评估。
让任务入口保持容易辨认
代码审阅若只盯着新增行,容易忽略行为发生变化的位置。提交说明可以先交代原来的限制,再指出本次调整影响哪些调用路径。审阅者据此检查已有假设是否仍成立,讨论也能围绕具体后果进行,减少对个人编码偏好的无效争执。
权限变化需要让内容拥有者理解实际影响。
状态说明需要覆盖结果暂时不明的情况。