用户为什么不读你的更新日志？5个原因及对策
浏览：2
巴克励步
我一直在琢磨一件事：产品团队花大量精力写更新日志，可用户就是不看。这不是用户的错，而是我们没把内容放在对的地方、用对的方式表达。说到这，我不得不提 Baklib 在产品手册建设上的实践——它帮助你将更新日志嵌入到产品文档中，通过多站点发布和 AI 搜索，让用户在你希望他们出现的任何页面都能找到最新动态。别让用户“找不到、看不懂”，那是我们该解决的问题。 你的更新日志太难找到要让用户读到你的更新日志，
我一直在琢磨一件事：产品团队花大量精力写更新日志，可用户就是不看。这不是用户的错，而是我们没把内容放在对的地方、用对的方式表达。说到这，我不得不提 Baklib 在产品手册建设上的实践——它帮助你将更新日志嵌入到产品文档中，通过多站点发布和 AI 搜索，让用户在你希望他们出现的任何页面都能找到最新动态。别让用户“找不到、看不懂”，那是我们该解决的问题。
你的更新日志太难找到
要让用户读到你的更新日志，首先得让他们能找到。如果这些文档只放在某个页码不起眼的角落，或者藏在“关于我们”这种八竿子打不着的地方，用户当然不会注意到——而你是希望他们注意到的。
更新日志详细记录了软件的新功能，阅读它能帮助用户从产品中获得更多价值。所以，引导用户找到这些内容至关重要。Amoeboids 总结得很到位：有效的功能营销策略之一就是宣传你的更新日志。尝试在发布新日志时通知用户，并附上直接链接。这样他们就能轻松找到新文档。
以下是一些可用的渠道：
💛🧡🧡客户评价：我们的IT团队需要一个存储库进行知识管理，以便我们的团队知识可以传承下去。在此外，我们正在寻找一种解决方案，使我们能够提供为我们的团队成员提供自助服务。Baklib提供了一个易于部署的低成本的解决方案，超出了我们的预期。优秀的知识管理平台。
- 将更新日志改编成博客文章，在公司博客上展示最新功能；
- 每次发布新日志时给用户发邮件——他们一定会注意到收件箱里的新消息；
- 应用内通知也很有效，一个简单的 3 天弹窗就足以引导用户查看新文档；
- 如果你有庞大的社交媒体关注者，在个人资料中告知他们新的更新日志。
这些方式的优势在于可以附带超链接，直接带领用户找到文档，避免他们浪费时间搜索。至于更新日志的实际存放位置，它们通常与路线图放在一起。前者记录软件的历史，后者展望未来。因此，将两者合并是合理的——更新日志中描述的功能很可能曾经就在路线图上。例如，Screenful 就将更新日志紧挨着路线图放置，概述了公司近期和即将取得的进展。
另一个常见的存放位置是知识库。知识库传达产品信息，更新日志也是如此，两者完美契合。例如 ChartHop 的更新日志就放在知识库中。整个文档结构——产品文档和更新日志——都是使用 Baklib 构建的。Baklib 可以将更新日志作为知识库组件附加到你的产品文档中，设置非常直观，方便用户快速找到更新日志。
你的更新日志太模糊
更新日志的目的是总结软件更新，让每个人都知道哪些新功能改进了产品。但要做到这一点，更新日志必须写得清晰。如果太模糊，读者就无法理解升级内容，可能会错过新功能。例如 Slack 的一条更新日志虽然有趣，但没什么实质内容。除了知道修复了一些 bug，读者一无所知。没有具体信息帮助用户。
相反，Jira 的 bug 修复日志虽然有点技术性，但考虑到 Jira 的典型用户是开发者，术语并不突兀。这些 bug 修复很详细，包含了无数细节，点击问题后会看到截图、环境细节、重现步骤等。频繁使用 Jira 的用户会非常欣赏这种详尽列表，从而立即知道自己的遗留问题是否已解决。
对于非技术受众，环境细节并不重要。相反，图片和视频是确保更新日志清晰的好方法。Trello 就采用了这种方式——添加一个视频来解释新功能，任何人看完都能立刻理解。事实上，他们可能根本不需要阅读文章其余部分，视频已经足够传达所有信息。
如果你手头没有视频，另一个避免模糊的策略是用链接充实内容。没人想读长篇大论的更新日志，但有些功能可能需要额外解释。为了保持简短又有用，使用链接吧。InVision 在解释滚动叠加时就这么做了：新用户可能还不知道什么是 overlay，更别提滚动叠加了。但 InVision 提供了帮助链接来解释这个术语，每个人都能快速跟上。用这个策略，你可以轻松创建清晰易读的更新日志。
你的更新日志太技术化
模糊的更新日志固然不好，但也要确保不要走向另一个极端——太技术化。任何人（不只是开发者）都可能想读更新日志，而且会有大量非技术用户访问。例如 Google 的一条更新日志充满了技术术语，像 Query API、整数字段类型、Faceting 支持等。许多非技术角色的用户很难理解这些调整，因为语言太专业了。考虑到 Google Workspace 的广泛采用，很多用户需要澄清。因此，最好编写易读易懂的更新日志，任何行业的人都能轻松理解。这样所有用户才能从产品中获得最大价值。MIT 高级讲师 John C. Friedly 也强调了这一点：归根结底，你不是为自己写更新日志。你自己已经知道所有功能变化，所以写的时候要设身处地为不了解的用户考虑。
你的更新日志没有叙述结构
更新日志不只是一个技术列表；它们应该讲述一个故事。Slite 的 Boris Jabès 曾说：“更新日志不应该是购物清单，而是故事。”如果你只是简单地罗列新功能和 bug 修复，没人会感兴趣。相反，用叙事结构来组织。例如，从介绍更新背景开始，然后描述功能如何工作，最后解释它给用户带来的好处。这样，读者就会像读一篇短文一样被吸引。例如，Baklib 的更新日志通常会按产品模块分组，并附带简短的价值说明，让用户一眼就能看出哪些更新与自己相关。
你没有推广更新日志
即使你的更新日志写得再好，如果没人知道它们的存在，也毫无意义。你需要主动推广。除了前面提到的渠道，你还可以在应用内设置“新功能”标签页，或者在下一次更新时用弹窗提醒用户。Baklib 提供了多种分发方式：你可以将更新日志发布为独立的站点，嵌入到帮助中心，甚至通过 API 推送到内联网门户中。关键是要让用户在需要的时候能够触达。
总结一下：用户不读更新日志，往往是因为我们做得不够好。找到合适的位置、写得清晰易懂、避免过于技术化、讲述故事、并且主动推广——做到这五点，你的更新日志就不再是无人问津的文档，而是用户喜爱的产品指南。Baklib 一直致力于帮助企业打造这样的内容体验，如果你正在为产品文档和更新日志犯愁，不妨试试。
