讓資料說明經得起復核
資料說明的讀者,可能並未參與最初的整理。閱讀界面需要同時幫助他們理解內容、找到依據,並分清哪些內容屬於解釋。
把來源放在判斷旁邊
當一段說明依賴某份資料時,應在相關位置保留出處,而不是把所有鏈接堆在文章結尾。來源記錄至少說明文檔名稱、可定位的位置及資料適用的時間範圍。這樣,讀者可以檢查原文是否支持相應表述。
比較前先對齊條件
兩個來源使用同一術語,並不保證討論同一對象。比較時先列出對象、範圍、時間與單位;條件不一致,就說明差異,或保留無法直接比較的判斷。把條件寫清楚,比給出一個脫離語境的總數更有幫助。
讓修訂有連續關系
正文修訂應說明變化涉及的段落及理由。來源更新、解釋調整與文字修正應分開處理,讓讀者理解哪項判斷需要重新核對。穩定的章節導航可以幫助讀者回到相關位置。
閱讀後的檢查
選擇文章中的一項判斷,檢查它是否有來源、適用條件和解釋依據。若其中一項缺失,先把問題記錄下來,再決定需要補充哪類資料。這一過程讓閱讀轉化為可以討論的問題。