读者理解的记录边界:操作手册的顺序安排的关系辨析,兼谈共同理解的重访过程
- 讨论起点
- 必要背景
- 关系说明
讨论起点
面向使用者的操作说明需要从先后关系入手理解,形成能够照着执行的操作资料之后仍可保留复核入口。围绕暂时无法回答的普通问题展开文字时,记得回应调整原因,对于可以回查的资料和缺项无法支持的说法应暂缓确认。不要绕过补充层次直接评价用于帮助理解的假设例子,还须对例子前提与所说明的关系保持一致的理解。先后关系发生变化时,应重新审视面向使用者的操作说明,对实际界面流程与限制条件的转述应保留原有条件。
必要背景
尚未说清的疑问的概括应与观察尺度相互对应,并将疑问涉及的对象中的含混之处单独提出。沿着先后关系逐项回看面向使用者的操作说明的说明,并说明操作前提与可见反馈为何与当前问题相关。先后关系发生变化时,应重新审视面向使用者的操作说明,同时追问操作前提与可见反馈是否已经得到核实。
关系说明
围绕面向使用者的操作说明展开文字时,记得回应先后关系,并留意实际界面流程与限制条件是否已经发生变化。先把面向使用者的操作说明与先后关系的关系说清,形成能够照着执行的操作资料之后仍可保留复核入口。对先后关系的忽略可能让面向使用者的操作说明的解释失去背景,能够照着执行的操作资料的作用是帮助理解而非替代依据。