让资料说明经得起复核
资料说明的读者,可能并未参与最初的整理。阅读界面需要同时帮助他们理解内容、找到依据,并分清哪些内容属于解释。
把来源放在判断旁边
当一段说明依赖某份资料时,应在相关位置保留出处,而不是把所有链接堆在文章结尾。来源记录至少说明文档名称、可定位的位置及资料适用的时间范围。这样,读者可以检查原文是否支持相应表述。
比较前先对齐条件
两个来源使用同一术语,并不保证讨论同一对象。比较时先列出对象、范围、时间与单位;条件不一致,就说明差异,或保留无法直接比较的判断。把条件写清楚,比给出一个脱离语境的总数更有帮助。
让修订有连续关系
正文修订应说明变化涉及的段落及理由。来源更新、解释调整与文字修正应分开处理,让读者理解哪项判断需要重新核对。稳定的章节导航可以帮助读者回到相关位置。
阅读后的检查
选择文章中的一项判断,检查它是否有来源、适用条件和解释依据。若其中一项缺失,先把问题记录下来,再决定需要补充哪类资料。这一过程让阅读转化为可以讨论的问题。