简单的视觉设计，适用于纯文本发布说明。

写版本发布说明是一件颇具争议的事情，有一些公司不费这样的事（他们通常有一些很好的理由），但另一些公司则尽心尽力地去写一些真正有吸引力的东西。

通过应用一些简单的结构和基本的格式，你可以大大提高你的版本注释的视觉舒适性，没有什么其他方式比只使用纯文本字符更能增强可读性和表现你的发布说明的经验。

本文对版本发布说明的几个关键点做了详细的讨论，最后定义了“最完美的格式化版本发布说明”。

最好的实践­——先摆结论，然后详细说明

如果你的开头是“你最好的朋友... ”，那么用户很有可能根本就读不到你的重点，英语世界有一句这样的俚语：TL; DR（too long; didn’t read），说的就是这。

写好一份版本发布说明应该从结论开始，为了那些没有时间详细阅读的人。然后才进入细节的说明取悦那些喜欢看细节的书呆子。

不要忘记最主要版本的说明

你在主要版本后发布了一个快速修复的版本？ 请务必将主要版本的发布说明粘贴在下面，不要忘记提醒大家你所做的伟大工作。

方便人们联系

版本更新的时候有一致的登录模块并且突出反馈的渠道能够帮助你避免负面评论。

发布说明要做到语言简洁并且要说到点子上，如 “我们重视您的反馈，请在这里联系[电子邮件]”。 作为交互设计的专业人士，这是一个很关键的工作， 你的用户越容易与你沟通越好。

基本格式化

打破它，我们不想要段落。 我们想要摘要。 如果有疑问，请以“• ”为每行的开头。 使用代表您的项目符号能够创造性地获得额外的影响。 如ESPN（即娱乐与体育节目电视网）使用[+]。 他们甚至走了一个额外的英里，也创建了一个符号– 获得创意是有趣的，但是不要为了手法而使用手法。 如果你做了一次，确保你每次都做，保持风格一致。 ESPN做了伟大的工作，总是坚持他们的自定义符号。

标题

你需要对你的记录进行分段并且使用能够被注意到的合适标题。 大写字母是标题最好的朋友（对中文而言，这点并不适用）。 用 - * =〜＃+ ...包装标题的两边， 任何你需要完成的工作，要确保一致，对所有标题始终使用相同的样式。

章节

新功能✨〜vs〜改进〜vs〜问题修复

进一步优化标题，把你的发布说明分解成你想要宣扬的新东西，以及你想要人们知道的事情。

不用说，新的东西应该永远是第一。

空间

文字之间留有空间让它呼吸，让用户更容易看到主要的点，而不是一墙的文本。

写作风格和内容的想法

不要害怕说出错误

修复了一个影响了很多人的错误？ 告诉他们！ 这是一个很好的机会，他们一直在等待这样的更新呢。 使用这个策略，当“小错误修复”并不会削减它。

把你的问题修复到一个整体的其他级别

（我不知道这有多少价值，特别是对你的组织外的任何人，但...）

考虑一下把问题修复归整到主要修订或主要版本发布，对于这个，我会说，你要么做，或者你不做，但不要忘记，一致性是关键。

即将到来的更新

不得不把这个版本发布出去，但你知道大的东西在拐角处？ 告诉人们它在路上！

个性化

与你的观众对话，而不是冷冰冰的机器化语言，用个性化介绍或其他方式打破冰冷的屏幕。

挑战和如何克服它们

由于在一家大型的多语言公司工作，我们面临着几个写版本发布说明的挑战。 这里有一些常见的问题，以及我们是如何克服它们的。

有些更新是微不足道的，在引擎盖或小像素调整...

不要一个人默默地写发布说明，启动协作文档，请设计师和开发人员也参与进来，每个人都为这个版本努力工作过！ 无论用户认为这是多么小的点， 如果你付出了努力，你的团队肯定会有话要说，您可以通过总结每个人的工作来轻松整合出一份内容丰富的版本发布说明。

但有时，我们需要发布真的很快错误修复...

...那很好。 超级小或无聊的问题修复可以称为“小错误”。 但有一些模板段落在你的储物柜中这样的情况。 混合它们以避免重复。

现在可能是一个好时机，添加一些个性化的内容，或者前面提到的反馈电子邮件地址。

但没有人读应用商店的更新！

大多数用户使用iOS和Android提供的自动更新功能，读应用商店中的更新说明的人数正在减少，这并不奇怪。（原作者在文章中放了一些例子，均截自app store）

但是，如果您已经采取了这些建议，您将对您的发行说明做出一些认真的努力。 如果这是演员，并且你想要与用户互动，不要等待用户阅读App Store！

相反，告诉他们有新的功能可用。 SofaScores做了一件非常好的事情，通过使用警报图标"·"，引导你到“新功能”页面，其中包含应用程序内的所有更新记录。

所有这些工作，你刚刚了解到的格式化版本发布说明不应该浪费。相同的副本和布局可以重复用于app内的新版本发布消息，或在应用程序“新增功能”更新。保持副本相同，无论如果你放在App Store或是在应用程序。

完美的发布说明

你等了很久的“完美发布说明”终于来了。你怎么把所有这一切拼凑在一起，它将在下文以纯文本方式展示：

介绍。一个短的段落。如果适当，请个人化。例如。 “季节的问候，大家！你问，圣诞老人听 ——这个更新正是你在这个圣诞节给用户的问候。

TL; DR

•这里有一个简短的摘要。

***新***

•这是您布局任何新功能的位置。

•解释这些功能在您的应用程序中的位置。

•用户如何找到这些新功能？

•哪些用户会受益，或者这将对他们有什么好处？

•例如“为什么？]我们现在自动支持您的Mac切换[在哪里/如何？]不要忘记打开蓝牙，您可以做它]！

***改进***

•如果改进现有功能，而不是全新功能，请使用“改进”标题而不是“新建”。

•如果您根据用户反馈改进了某些内容，请考虑一句话，“您问，我们听了”。一个伟大的方式，使您的用户感到重视。

***固定***

•列出可能影响许多用户的任何主要错误。

•如果您只解决了一些小问题，或没有具体的问题，请使用类似：

•例如“修正了一些小错误”

•如果您包含其他标题部分，请保留“固定”标题。

签字。类似于介绍，如果适当，这可以个性化。你可以很容易地有几个这样的变化。

最后反馈。添加反馈电子邮件地址并欢迎用户的想法。例如。 “提交您的建议改进feedback@yourapp.co我们重视您的反馈”

结语

我的老老板的话，它已经印在我脑海里很长一段时间：

从“平均”到“好”的差距很大，人们需要努力工作才能达到“好”。 但是，从“好”到“优秀”，它只有2毫米额外的距离。 然而人们乐于解决“好”， 他们从来不知道他们是多么接近真正的优秀- Danyl Bosomworth（基于Tony Robbins的2毫米规则）

良好的格式和写好的发行说明，就是这2毫米差异的一个很好的例子。 一个小小区别，将有助于推动你的应用程序从“好”到“优秀”。

如果你是一个设计师，找到你的版本发布经理和项目负责人，带上你对排版和布局的理解（更不要说你应该引以为豪的已经完成工作），并帮助他们达到额外的2毫米。

译者注：

由于作者使用的例子是英文，所以未在译文中放出，有兴趣的朋友可以阅读原文。