原文標(biāo)題：As a Designer I want better Release Notes ——Simple visual design, applied to plain text release notes
作者：Rob Gill，UX Manager @PerformGroup.
翻譯：王很遠(yuǎn)
原文地址

寫版本更新說明是個(gè)有爭議的話題喊废。有些公司選擇簡單處理（通常有一個(gè)「好」理由^[1] ）祝高，有些公司則煞費(fèi)苦心^[2]。

通過應(yīng)用簡單的文本結(jié)構(gòu)和基本版式污筷，在只使用純文本的前提下工闺，也可以大大提升你的版本說明的視覺效果和閱讀體驗(yàn)。本文涵蓋幾個(gè)關(guān)鍵領(lǐng)域瓣蛀，最后提供「完美的版本說明模版」陆蟆。

最佳實(shí)踐

1.先總結(jié)再詳述

大家都很忙的，先從總結(jié)開始惋增，再說明更新細(xì)節(jié)叠殷。

TL；DR.（太長不看）——1Password 和 Medium 都使用過這種先總結(jié)再說明細(xì)節(jié)的方法

2.重新提醒重大更新

如果在發(fā)布一個(gè)大版本之后緊急修復(fù)了重大 Bug 诈皿，確保在新版本的說明中再次提醒上個(gè)版本的重大更新林束。有助于未及時(shí)更新的用戶了解你更新的新功能。

在大版本后修復(fù) Bug稽亏？別忘了你那些幸苦的工作

3.讓用戶輕松聯(lián)系到你

一個(gè)統(tǒng)一的外部反饋渠道可以有效避免負(fù)面評(píng)價(jià)壶冒。確保這里的文案簡潔到位〈胱螅「我們很重視您的反饋意見依痊，您可以通過這些渠道聯(lián)系我們：Email、QQ 群、微信 etc.」如何讓用戶的反饋渠道更簡單方便胸嘁，是專業(yè)用戶體驗(yàn)設(shè)計(jì)的關(guān)鍵瓶摆。

The Guardian & Onefootball

基本版式

1.項(xiàng)目符號(hào)

• 拆分說明，不要使用大段文本性宏，請(qǐng)精煉總結(jié)
• 每個(gè)功能點(diǎn)單獨(dú)占一行群井，行首建議使用圓點(diǎn)「?」
• 可以使你的項(xiàng)目符號(hào)富有創(chuàng)造性以獲取額外效果。例如 ESPN 使用「+」
• 甚至可以在一個(gè)項(xiàng)目下使用子項(xiàng)目
• 保持創(chuàng)造性是很有意思的事毫胜，但是別嘩眾取寵书斜。一旦你確立了一種寫作風(fēng)格，一定要自始而終保持統(tǒng)一酵使。ESPN 一直都保持他們獨(dú)特的風(fēng)格符號(hào)

使用項(xiàng)目符號(hào)分割能使一坨文本快速提升可讀性--IMDB & ESPN

2.小標(biāo)題

你可能還需要使用小標(biāo)題來區(qū)分更新的功能點(diǎn)荐吉。考慮使用一些符號(hào)譬如「-口渔、#样屠、+、*」來表示小標(biāo)題缺脉。不管如何你還是要確保寫作風(fēng)格保持統(tǒng)一痪欲。

標(biāo)題 —— Two Dots &Trello

3.區(qū)分內(nèi)容

新特性 vs 改善 vs BUG FIXES

使你的標(biāo)題更簡潔精煉。把你的版本更新說明分解為你需要用戶知道的新特性攻礼，還有已修復(fù)的問題业踢。新特性／功能應(yīng)該寫在前面。

Mindnode & 1Password

4.空間

你的段落應(yīng)該留有呼吸空間礁扮。使你的用戶更容易閱讀每個(gè)更新點(diǎn)而不是丟給用戶一大坨文本知举。

沒有對(duì)比就沒有傷害 ——Outlook & Slack

寫作風(fēng)格和內(nèi)容觀點(diǎn)

1.不要擔(dān)心把 Bug 說出來

修復(fù)了一個(gè)影響大量用戶的 Bug？快告訴他們吧深员！這對(duì)他們來說是一個(gè)很好的改進(jìn)负蠕。小修小補(bǔ)則可略過。

Clear Score 宣布解決了一個(gè)大問題

2.把你的 Bug Fixes 提升到另一個(gè)高度

（我不知道這樣做有沒有卵用倦畅，尤其是對(duì)外部人員來說遮糖。但是誰知道呢……^[3]）
考慮把錯(cuò)誤代碼寫進(jìn)你的版本說明。我想說的是叠赐，這一步做不做都關(guān)系不大欲账。但是別忘記，寫作風(fēng)格統(tǒng)一是關(guān)鍵芭概。

1Passeword 喪心病狂地把錯(cuò)誤編號(hào)也寫上

3.即將更新

有些功能研發(fā)過程很曲直赛不，但是你知道這些大招就要完成研發(fā)“罩蓿快告訴用戶一切都在計(jì)劃之中踢故，新功能就要憋出來啦文黎！

就快憋出來了，再等等…… —— IFTTT

4.個(gè)性化

熱情地和你的受眾人群打招呼別害羞殿较。

Onefootball & Photobox 使用了討巧的寫作風(fēng)格

如何克服挑戰(zhàn)

在一個(gè)多語言的大公司工作耸峭，對(duì)于版本說明我們面臨許多挑戰(zhàn)。以下是我們解決常見問題的一些方法淋纲。

1.許多細(xì)微的更新劳闹，比如底層和小像素調(diào)整：

不要獨(dú)立寫版本說明。如果你付出了努力洽瞬，你的團(tuán)隊(duì)肯定有話要說本涕，無論用戶認(rèn)為改動(dòng)多么小。每個(gè)人都為這個(gè)版本付出了努力伙窃，使用協(xié)作文檔讓每個(gè)人都參與進(jìn)來菩颖，最后總結(jié)輸出。

2.有些時(shí)候对供，我們需要快速發(fā)布版本以修復(fù) Bugs：

超級(jí)小或者無聊的 Bugs Fixed 可以成為寫成「Bugs fixes（修復(fù)小錯(cuò)誤）」位他。但是準(zhǔn)備一段貼心的反饋路徑或個(gè)性化應(yīng)用說明可以避免這種重復(fù)。

3.沒人閱讀應(yīng)用商店的更新說明怎么辦

隨著 iOS 和 Android 推出自動(dòng)更新功能以來产场，毫無疑問在應(yīng)用商店閱讀更新說明的人越來越少。
如果你采取了以上的建議舞竿，你肯定會(huì)認(rèn)真對(duì)待你的版本說明京景。如果你想要與用戶產(chǎn)生互動(dòng)，千萬不要等著用戶去應(yīng)用商店閱讀你的版本說明骗奖。
在告訴用戶新特性（功能）的引導(dǎo)上确徙，SofaScores 做了很好的示范。通過醒目的小紅點(diǎn)执桌，引導(dǎo)用戶去到有詳細(xì)說明更新內(nèi)容的「What's New」頁面鄙皇。

SofaScores 在應(yīng)用內(nèi)完成引導(dǎo)

另外，你用心排版編寫版本說明不應(yīng)該浪費(fèi)仰挣。相同的文案和版式可以在宣發(fā)郵件或 App 內(nèi)部的 What's New 頁面重復(fù)使用伴逸。不管在 App 內(nèi)部或 App Store Withings 的文案都保持一致。

Withings 內(nèi)部和 App Store 上的文案一致

理想的版本說明

以下是一份理想版本說明模板

開頭寫一段簡短的個(gè)性化介紹膘壶。比如說「Hi错蝴，老鐵！春天到了颓芭，這個(gè)版本>我們也更新了許多生氣勃勃的功能和提升了整體性能哦顷锰！」

TL；DR（Too long亡问；Didn't read 的簡寫：太長不看）

• 這里寫上這個(gè)版本說明的總結(jié)

~ 新功能 ~

• 這里寫上新功能是什么
• 解釋這些功能在你 App 中的位置
• 用戶如何找到這些新功能- 哪些用戶會(huì)受益官紫，或者這對(duì)他們有什么好處
• 舉個(gè)栗子：（誰會(huì)受益？）Apple Watch 用戶會(huì)對(duì)最新版本特別滿意。（為什么束世？）我們現(xiàn)在支持與您的 Mac 自動(dòng)切換酝陈。（在哪里／如何？）不要忘記打開你的藍(lán)牙良狈，你是最棒的后添！

~ 改進(jìn)~

• 如果改進(jìn)現(xiàn)有功能（而不是全新功能），請(qǐng)使用「改進(jìn)」標(biāo)題而不是「新功能」
• 如果你根據(jù)用戶的反饋改進(jìn)了某些內(nèi)容薪丁，試著使用這樣的句子遇西，例如「你說，我們聽」严嗜。讓用戶感受到他們是受重視的粱檀。

~ 修復(fù) ~

• 列出影響大量用戶的 Bugs- 如果只是修復(fù)了小問題，請(qǐng)使用這樣的句式「修復(fù)了一些小錯(cuò)誤」
• 如果你使用了分標(biāo)題編寫說明的話漫玄，請(qǐng)保留「修復(fù)」這個(gè)小標(biāo)題

這里是底部簽名茄蚯。類似于介紹，盡可能個(gè)性化一點(diǎn)睦优。你要知道渗常，有這樣一個(gè)介紹段落也是極好的。

最后是反饋渠道汗盘，可以是 Email 地址皱碘、QQ 群號(hào)、微信號(hào)等隐孽。確保用戶可以方便的聯(lián)系到你癌椿。例如：
您可以通過以下方法聯(lián)系我們，告訴我們您的寶貴意見：
QQ 群：XXXXXX
Email 地址
微信號(hào)

從「好」到「優(yōu)秀」

我前老板的一段話影響了我很長一段時(shí)間菱阵。

從「平庸」到「好」的差距很大踢俄，人們需要努力工作才能達(dá)到「好」。但是晴及，從「好」到「優(yōu)秀」只有極短的 2 毫米的距離都办，他們從來不知道他們離實(shí)現(xiàn)「優(yōu)秀」是多么接近。
——Danyl Bosomworth（基于 Tony Robbins 的 2 mm 規(guī)則）

編寫優(yōu)雅的版本說明抗俄，是 2 毫米差異一個(gè)很好的例子脆丁。一個(gè)小區(qū)別，對(duì)于推動(dòng)你的 App 從「好」到「優(yōu)秀」有著極大的幫助动雹。
如果你是設(shè)計(jì)師槽卫，找到你的發(fā)布經(jīng)理或項(xiàng)目經(jīng)理。用你的專業(yè)知識(shí)胰蝠，幫助他們達(dá)成這額外的 2 毫米歼培。

1. Facebook 員工解釋 Facebook Release Note 簡單的原因
   https://www.reddit.com/r/iphone/comments/2jcy4r/facebook_replies_to_outrage_over_lack_of_changelog/ ?

2. Slack 員工 Anna Pickard 對(duì)編寫 Release Note 的建議
   https://slackhq.com/a-little-thing-about-release-notes-997d2e06842d ?

3. 確實(shí)沒什么卵用 ?