*節(jié)選自 Developing Quality Technical Information, A Handbook for Writers and Editors, 2nd Edition *
從讀者角度呈現(xiàn)信息很容易把讀者帶入“故事”贸辈,讀者容易想象你所描述的任務(wù)的執(zhí)行過程。
這種寫作方式有以下特點(diǎn):
- 明確的指向性肠槽,多以第二人稱(you)為主語擎淤。
- 使用主動語態(tài),使用不同動詞秸仙,區(qū)分讀者要進(jìn)行的動作與產(chǎn)品本身進(jìn)行的動作嘴拢。
- 給出動作的原因。
以下通過幾個示例進(jìn)行說明寂纪。
示例一
評析:
修改前:使用了被動語態(tài)席吴,動作主體及原因均不明確。
修改后:修訂版本中捞蛋,將讀者作為動作參與者孝冒,“you might lose data” 也闡述了該動作的理由,與讀者聯(lián)系起來——“他們不想丟失數(shù)據(jù)”拟杉。
示例二
評析:
修改前:讀者并不能十分清楚原稿中信息與他們有何關(guān)聯(lián)庄涡。
修改后:在修改后的版本中,將讀者納入到“故事”中搬设,解釋說明了他們?yōu)槭裁匆褂眠@個功能穴店。
提供一個任務(wù)幫助時撕捍,你十分清楚讀者當(dāng)前所在的界面位置,因而也十分清楚進(jìn)行任務(wù)的哪一部分讀者會需要幫助迹鹅。這一優(yōu)勢能幫助你很好地從讀者的角度組織針對性的主題信息卦洽。
示例三
以下是個幫助信息贞言,假定讀者需要獲取Create Table向?qū)У腜rimary Key 頁面(一個第三方頁面)的幫助信息斜棚。
評析:
修改前:若讀者已完成了了“Creating a table” 任務(wù)的大部分步驟,僅僅需要知道如何指定primary key的一些信息该窗,即creating table的子步驟弟蚀。修改前的版本成功地“浪費(fèi)”了讀者的時間,提供了很多已經(jīng)完成的步驟酗失。
修改后:從讀者當(dāng)前可能的位置出發(fā)义钉,組織任務(wù)信息,同時還提供了primary key概念的鏈接规肴,以防有些讀者在開始任務(wù)之前需要了解這些背景信息和概念捶闸。
一旦理解了讀者的角度,你就可以寫出基于任務(wù)的主題信息拖刃,以幫助讀者順利完成任務(wù)删壮。