如何在7个步骤中写（更好）发行说明

钥匙要点

• >了解您的目标受众及其阅读发行说明的原因；这将指导注释的语气，内容和呈现。
• 清楚地记录了当前版本中所做的更改，考虑到您的读者需要了解的内容以及何时需要访问信息。
决定在发行说明中包含什么，根据其感知的重要性或复杂性平衡每个项目的覆盖范围。
• >
>使用写得良好的发行说明作为其他通信（例如博客文章或电子邮件）的基础，以突出针对不同用户段的新产品功能。

对于某些业务，发行说明是将产品增强功能传达给客户的唯一方法。对于其他人来说，它们是一个副线，完全与用户通信分开开发。

>

但是，如果您想以更少的速度做更多的事情 - 如果您想改善客户保留通信而不必做更多的工作 - 您的发行说明可能是一个出乎意料但有价值的答案。特别是如果他们做得好。

发行说明记录了新功能，功能增强功能以​​及错误修复。它们通常是简洁明了的，自然而然地对您的产品熟悉。我在下面提出的过程应该使您可以轻松地为您的产品制作出色的发行说明，以满足您的业务和客户的需求。

>，但是，如果您愿意，此过程还将为您提供其他发布通信（例如电子邮件，博客文章或功能之旅）的可靠饲料，这些过程可以帮助客户提醒您对改善您提供的东西的努力。面对现实吧，我们都想知道即使我们做出了选择并签署了服务之后，我们也很喜欢。

>

>让我们看看这如何对您有用。

1。要明确目标受众，以及笔记的目的

>

谁阅读发行笔记？对于某些产品，大多数用户将查看每个发行说明；对于其他人来说，这是主要用户群的非常精选的特定子集。

>

>一旦您知道谁是为谁创建发行说明，就可以理解他们为什么要阅读笔记。这将驱动下一步。

>我从事的产品的发行说明没有任何人阅读，但是关键客户端帐户中的用户很少。他们有阅读发行说明的非常具体的原因 - 例如，有些人需要保持更新。

>但对于某些产品，发行说明是由大部分想要避免营销旋转的用户阅读的 - 他们想了解产品的核心并直接听取其制造商的声音。这样的知识不仅会告知您包含的内容并排除在内 - 它会影响您写笔记的语气以及如何呈现它们的语气。

>

2。弄清楚他们需要知道的

通常期望发行说明记录您的产品当前发行版中已进行了哪些更改。因此，很明显，您会知道

>您的>需要读者知道什么。>

>，考虑到您的读者认为需要了解的知识也很重要。例如，我们以确保报告或注意到该错误可以在列表中识别并知道其已修复的任何人进行记录错误修复。但是，我们不会对每个错误修复进行深入研究，因为没有人需要阅读所有信息（或者说实话）。

> 在这一点上，考虑读者何时需要访问发行说明也是一个好主意。在释放当天？一周前，他们有时间审查它们？这将帮助您安排围绕实际构建和部署发行版的工作的发行说明的创建。

3。确定您在此版本中所做的工作

>听起来很简单，但是如果您为此步骤提出了一个好的过程，它将平滑每个发行说明的产生。 例如，您可能会决定拥有一个共享的文档，即您的开发人员和产品所有者可以随着工作的完成而不是在结束时逐步更新，这可能会使您试图匆忙编译笔记。

>

>您可能还将该文档分解为反映通常完成的工作的各个部分，例如，新功能，对现有功能的增强以及错误修复。这将使您可以轻松查看文档中是否包含所有版本中的所有内容。>

>它本身也将使构建发行说明本身更容易，而不是只有一个新内容的列表。

>

4。确定您需要包含的内容

>由于它们向您的发行说明文档提供信息，因此您的开发人员和产品所有者可能不会考虑最终用户。因此，在准备发行说明时，您需要弄清楚要包含哪些信息以及可以省略的信息。

>我特别考虑上面提到的错误修复程序，但是您可能还必须平衡某些人的挥发性贡献与其他人对笔记的较薄贡献的贡献。

关于一个功能或增强的更多单词，屏幕截图和详细信息通常会比另一个功能或增强，以反映该项目的相对重要性或复杂性，因此请记住这一点列表。

5。如果您需要

，请制定故事情节或消息传递

>并非总是需要，但是有时故事情节可以帮助您将改进置于上下文中。我不是在说为此而添加单词，也不是将您的精美发行说明变成营销工具。我的意思是，您提供信息的顺序可以帮助用户了解您所做的更改。因此，请考虑一下。

例如，我准备的最新发行说明提到了产品的改头换面，以及主要功能添加。改头换面仅仅是化妆品的变化，它不会影响界面中项目位置的功能。功能添加是一项更大的工作，对用户的长期影响更大。

您先涵盖哪个？我们选择通过改头换面打开，因为这是用户下次使用我们的软件时首先注意到的。此后列出了新功能，但包含更多的屏幕截图和细节。这很有意义的原因之一是因为新功能看起来与应用程序的其余部分明显不同，因此将其放置在视觉刷新的背景下，使我们可以跳过对这个事实的更多讨论。

6。起草笔记

>大多数用户期望发行是直接和简洁的。他们在那里得到事实。也就是说，最好从目标受众的角度来解释每个功能或修复。这对他们意味着什么？

> 例如，对您的应用程序进行更改可能会使您的支持人员更容易为企业客户端设置其他用户帐户。这对发行说明的用户意味着：对于这些客户的新员工而言，它更快或更容易访问公司帐户。因此，用这些术语来。

>

7。重新利用您对其他通信的需要

>如果他们的计划和书写精心，您的发行说明可以充当其他通信的跳板，可能针对其他用户受众群，以突出产品中的新事物。

>一旦您钉了发行说明，就应该很容易看到可以在应用内通知或旅行中重新重新重新构建的内容，用于查看帮助内容，并重新使用和发展到博客文章，新闻通讯项目和其他保留内容。

您如何开发发行说明？

>

就是这样，不是一个困难的过程，尽管如果您的生产过程中有许多活动部件，则发行笔记可能需要做一些。

>

>但是，如果您制作出良好的发行说明，则可以从投入其中的工作中获得更多。在向更广泛的受众传达更改的更改时，他们可以为您带来真正的开端，而不是现在阅读您的发行说明。

您是否有制作发行说明的过程？他们会发挥您的客户保留工作吗？我很想听听您在评论中的做法。

>

经常询问有关编写更好的发行说明

的问题

>在有效的发行说明中包含哪些关键元素？

有效的发行说明应包括清晰的标题，简介，新功能，改进和错误修复以及任何已知问题。包括确认和结论的部分也是有益的。标题应该简洁明了，而引言应简要概述该版本。新功能，改进和错误修复的列表应详细且易于理解。已知问题部分应告知用户任何潜在问题以及如何避免问题。最后，可以使用确认和结论来感谢团队和用户，并提供有关未来更新的信息。

>

>如何使我的发行说明更具吸引力？注意更具吸引力，使用对话语调并避免使用技术术语。使用子弹点和子标题分解文本并使其更易于阅读。包括屏幕截图或GIF等视觉效果，以说明新功能或改进。您还可以在开发团队中包括用户推荐或报价来添加个人触摸。

>

>我应该多久发布一次发行说明？

发布发行说明的频率取决于您产品的开发周期。如果您有定期更新，则最好使用每个新版本发布发行说明。但是，如果更新的频率较低，则可以每季度或半夜发布发行说明。关键是要使您的用户了解您的产品的更改和改进。

>我是否应该在发行说明中包含技术细节？您的产品，避免在发行说明中包含太多技术细节。相反，专注于解释新功能的好处或改进用户。如有必要，您可以提供指向更详细的技术文档的链接。

>我如何获得发行说明的反馈？

您可以通过直接询问您的用户来获得发行说明的反馈。在您的发行说明中包含一个反馈表或评论部分。您还可以使用社交媒体或用户论坛来收集反馈。这不仅可以帮助您改善发行说明，而且还可以与用户建立更牢固的关系。

>

我如何使用发行说明来推广我的产品？突出显示产品中的新功能和改进，并解释它们如何使用户受益。您还可以包括一个电话，鼓励用户尝试新版本或提供反馈。在您的网站，社交媒体和电子邮件新闻通讯上分享您的发行说明，以吸引更广泛的受众。

>我应该在发行说明中避免什么？发行说明中的​​负语言。另外，除非您确定可以交付，否则避免对将来的更新做出承诺。保持您的发行说明简洁，清晰，并专注于用户的需求。

>如何使我的发行笔记更容易访问？

>

使您的发行说明更易于访问，使用清晰而简单的语言。用子弹点和子标题分解文本，并使用视觉效果来说明复杂的概念。另外，请确保您的发行说明易于在您的网站或应用程序上找到。

>我应该将发行笔记转换为其他语言吗？

>

>如果您的产品具有全球用户群，则是一个将您的发行笔记转化为其他语言的好主意。这将帮助您吸引更多的受众，并表明您重视国际用户。

>我如何随着时间的推移改进我的发行笔记？

不断收集用户的反馈并监视您的发行说明。使用此信息进行改进和调整。另外，跟上发行笔记写作中的最佳实践和趋势。请记住，有效的发行说明是持续学习和改进的结果。

以上是如何在7个步骤中写（更好）发行说明的详细内容。更多信息请关注PHP中文网其他相关文章！