文件整齐之外还需状态,给不同长度的文字留空间,在取消之后说明当前结果
1030 · 问答社区
注释适合解释不能从代码直接看出的约束。某个看似多余的检查也许为了兼容旧文件,删掉之后才会暴露问题。把保留原因与可以移除的条件写在附近,能够帮助后来者作出判断,也比逐字复述下一行代码更容易在修改时提供实际价值。
文件整齐之外还需状态
帮助内容应围绕任务,而不是只列页面上的控件。
状态说明需要覆盖结果暂时不明的情况。
给不同长度的文字留空间
撤回已发送消息的功能,需要解释对方可能已经阅读。若提示只写撤回成功,用户可能理解为信息从未被看见。可以准确表达当前动作改变了什么,并说明仍无法控制的部分,让反馈围绕可确认结果展开,而不是用一个简短成功标签承诺超出实际能力的效果。
页面简洁与信息可发现,需要放在一起考虑。
旧内容如何处理,是功能退出说明中的重要部分。
在取消之后说明当前结果
插件能力的开放范围应围绕清楚的扩展点。直接允许外部组件访问全部内部状态,可能让升级受制于不可见依赖。可以提供稳定契约与必要权限,并把不保证兼容的部分明确隔离,让扩展者知道可以依赖什么,也让主应用仍有调整内部结构的合理空间。
撤销范围应与提示给出的预期相符。
通知需要说明为什么在此刻出现。
问题说明
- 支持沟通可以先复述对方实际看见的现象。
- 导出范围最好在操作发生之前清楚可见。
阅读提示
本文为原创阅读素材,内容用于情境讨论,不对应现实事件或实际服务承诺。
继续了解
从具体问题整理概念,从近邻概念之间辨认差别,在分类之外保留交叉关系从使用场景检查定义是否清楚,一个例子不能承担全部证明,让卡片标题帮助未来查找把设备状态说明清楚,把体感放回空间条件,一项经验如何适合另一家把反例留给下一次比较,给不同能力留出操作余地,节约讨论也要照顾舒适把做对一次放回完整过程,用完整小任务检验新技能,在错误步骤找到线索周末安排不必填满每一格,从一次使用发现收纳问题,在日常交谈里说明真实需要先把陌生房间了解清楚,给旅程留下调整余地,没有走到终点也能完整记录把个人习惯放回实际条件,把多余期待换成一次确认,从进门动作整理日常一起做事之前先分清步骤,感谢心意也能保留生活边界,把饭桌上的默认期待说开把公共反馈接到后续,活动结束后记下实际困难,把未解决事项带到下一次从一次使用发现收纳问题,沿着做饭顺序调整厨房,从临时需求看见空间缺口类比也要标出不能照搬处,给未知信息一个明确的位置,先说明概念回答什么问题