從讀者角度呈現(xiàn)信息

*節(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)行說明寂纪。

示例一

image.png

評析:
修改前:使用了被動語態(tài)席吴,動作主體及原因均不明確。

修改后:修訂版本中捞蛋,將讀者作為動作參與者孝冒,“you might lose data” 也闡述了該動作的理由,與讀者聯(lián)系起來——“他們不想丟失數(shù)據(jù)”拟杉。

示例二

image.png

評析:
修改前:讀者并不能十分清楚原稿中信息與他們有何關(guān)聯(lián)庄涡。

修改后:在修改后的版本中,將讀者納入到“故事”中搬设,解釋說明了他們?yōu)槭裁匆褂眠@個功能穴店。

提供一個任務(wù)幫助時撕捍,你十分清楚讀者當(dāng)前所在的界面位置,因而也十分清楚進(jìn)行任務(wù)的哪一部分讀者會需要幫助迹鹅。這一優(yōu)勢能幫助你很好地從讀者的角度組織針對性的主題信息卦洽。

示例三
以下是個幫助信息贞言,假定讀者需要獲取Create Table向?qū)У腜rimary Key 頁面(一個第三方頁面)的幫助信息斜棚。

image.png

image.png

評析:
修改前:若讀者已完成了了“Creating a table” 任務(wù)的大部分步驟,僅僅需要知道如何指定primary key的一些信息该窗,即creating table的子步驟弟蚀。修改前的版本成功地“浪費(fèi)”了讀者的時間,提供了很多已經(jīng)完成的步驟酗失。

修改后:從讀者當(dāng)前可能的位置出發(fā)义钉,組織任務(wù)信息,同時還提供了primary key概念的鏈接规肴,以防有些讀者在開始任務(wù)之前需要了解這些背景信息和概念捶闸。

一旦理解了讀者的角度,你就可以寫出基于任務(wù)的主題信息拖刃,以幫助讀者順利完成任務(wù)删壮。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市兑牡,隨后出現(xiàn)的幾起案子央碟,更是在濱河造成了極大的恐慌,老刑警劉巖均函,帶你破解...
    沈念sama閱讀 222,104評論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件亿虽,死亡現(xiàn)場離奇詭異,居然都是意外死亡苞也,警方通過查閱死者的電腦和手機(jī)洛勉,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,816評論 3 399
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來如迟,“玉大人坯认,你說我怎么就攤上這事∶セ粒” “怎么了牛哺?”我有些...
    開封第一講書人閱讀 168,697評論 0 360
  • 文/不壞的土叔 我叫張陵,是天一觀的道長劳吠。 經(jīng)常有香客問我引润,道長,這世上最難降的妖魔是什么痒玩? 我笑而不...
    開封第一講書人閱讀 59,836評論 1 298
  • 正文 為了忘掉前任淳附,我火速辦了婚禮议慰,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘奴曙。我一直安慰自己别凹,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,851評論 6 397
  • 文/花漫 我一把揭開白布洽糟。 她就那樣靜靜地躺著炉菲,像睡著了一般。 火紅的嫁衣襯著肌膚如雪坤溃。 梳的紋絲不亂的頭發(fā)上拍霜,一...
    開封第一講書人閱讀 52,441評論 1 310
  • 那天,我揣著相機(jī)與錄音薪介,去河邊找鬼祠饺。 笑死,一個胖子當(dāng)著我的面吹牛汁政,可吹牛的內(nèi)容都是我干的道偷。 我是一名探鬼主播,決...
    沈念sama閱讀 40,992評論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼记劈,長吁一口氣:“原來是場噩夢啊……” “哼勺鸦!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起抠蚣,我...
    開封第一講書人閱讀 39,899評論 0 276
  • 序言:老撾萬榮一對情侶失蹤祝旷,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后嘶窄,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體怀跛,經(jīng)...
    沈念sama閱讀 46,457評論 1 318
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,529評論 3 341
  • 正文 我和宋清朗相戀三年柄冲,在試婚紗的時候發(fā)現(xiàn)自己被綠了吻谋。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,664評論 1 352
  • 序言:一個原本活蹦亂跳的男人離奇死亡现横,死狀恐怖漓拾,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情戒祠,我是刑警寧澤骇两,帶...
    沈念sama閱讀 36,346評論 5 350
  • 正文 年R本政府宣布,位于F島的核電站姜盈,受9級特大地震影響低千,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜馏颂,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,025評論 3 334
  • 文/蒙蒙 一示血、第九天 我趴在偏房一處隱蔽的房頂上張望棋傍。 院中可真熱鬧,春花似錦难审、人聲如沸瘫拣。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,511評論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽麸拄。三九已至,卻和暖如春葱绒,著一層夾襖步出監(jiān)牢的瞬間感帅,已是汗流浹背斗锭。 一陣腳步聲響...
    開封第一講書人閱讀 33,611評論 1 272
  • 我被黑心中介騙來泰國打工地淀, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人岖是。 一個月前我還...
    沈念sama閱讀 49,081評論 3 377
  • 正文 我出身青樓帮毁,卻偏偏與公主長得像,于是被迫代替她去往敵國和親豺撑。 傳聞我的和親對象是個殘疾皇子烈疚,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,675評論 2 359

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn)聪轿,斷路器爷肝,智...
    卡卡羅2017閱讀 134,707評論 18 139
  • 1. Java基礎(chǔ)部分 基礎(chǔ)部分的順序:基本語法,類相關(guān)的語法陆错,內(nèi)部類的語法灯抛,繼承相關(guān)的語法,異常的語法音瓷,線程的語...
    子非魚_t_閱讀 31,664評論 18 399
  • MySQL技術(shù)內(nèi)幕:InnoDB存儲引擎(第2版) 姜承堯 第1章 MySQL體系結(jié)構(gòu)和存儲引擎 >> 在上述例子...
    沉默劍士閱讀 7,423評論 0 16
  • 一. Java基礎(chǔ)部分.................................................
    wy_sure閱讀 3,814評論 0 11
  • 2017.7.29 周六 李彤 月芽寶貝36天 天氣涼快对嚼,麻麻和寶貝一樣開心,寶貝臉上身上小痱痱小疹疹基本都逃離啦...
    樸落閱讀 291評論 0 0