Netlify 文档页面上的 Astro
现在您在 Netlify 上拥有一个出色的 Astro 项目,请查看有关在 Netlify 上使用 Astro 的其他资源。
随着新功能的推出和现有功能的更新,一群热情的 Netlify 技术作家确保Netlify 文档网站拥有全面、最新的文档。但是,这些时髦的新文档发布后会发生什么?虽然我们很容易满足于现状并称工作已完成,但 Netlify Docs 团队会监控多个渠道以获取用户反馈,并进行迭代改进以解决清晰度、内容差距或更正问题。这篇文章总结了我们实现这一奇迹的过程。
反馈表
在每个文档页面的底部,我们都提供了一个表单,供客户与我们分享反馈。他们可以通过点赞/点踩来评估页面的实用性,并发表评论分享自己的想法。当读者通过此表单提交反馈时,提交会触发一个无服务器函数,该函数将信息传输到内部 Slack 频道以及电子表格。
但是我们能得到多少反馈呢?正如 Bob Watson 在他的 Docs by Design 博客中指出的那样,即使文档反馈在统计上并不显著,它也是有用的。对于我们的网站,我们每 10,000 次页面浏览量会收到大约 14 条反馈,这仅占 0.14%。其中大约一半是自由形式的评论。我们发现赞成/反对投票在总体上是有用的,我们会以临时方式参考这些数字,例如通知内容大修项目的优先级。但自由形式的评论是我们获得最可行见解的地方。
文档团队设置了反馈表轮换,每周有一名技术作家负责审查所有收到的新评论,并找出我们可以采取哪些措施来改进我们的文档。有时,我们会得到很好的赞美,有时也会得到完全偏离主题的评论,比如有人自 约旦 Whatsapp 数据 称喜欢侠盗猎车手,或者要求我们免费提供钻石。有些反馈太模糊而无法采取行动,或者涉及的极端情况不值得在文档站点中介绍。不过,许多评论揭示了针对客户痛点的可行见解。在过去六个月中,文档团队根据这些反馈发布了 40 条更新。我们还使用这些信息来提交新问题、添加对现有问题的见解,并将功能请求传递给产品团队的同事。
支持配对
另一个有用的客户反馈来源是我们的支持和社区团队成员。每周,都会有不同的技术作家轮流与同事同步,以针对我们支持论坛和客户支持单中标记的文档反馈采取行动。在过去六个月中,我们根据通过此渠道收到的项目进行了十几次更新。由于我们在 Netlify 上构建了 Netlify,因此我们在进行这些更新时利用协作部署预览来收集支持同事的评论。
我们已将 Docs 团队组织起来,将作者嵌入专注于 Netlify 平台特定领域的小组中。虽然这对于建立背景知识和跨职能团队关系很有用,但这种设置可能会限制 Docs 团队在特定重点领域之外的知识。参与与反馈相关的轮换工作有助于我们保持对用户的同理心,并了解 Netlify 平台的全部功能。它还有助于我们成为支持部门的好队友。我们致力于使我们的文档清晰、准确和完整,以转移未来的支持票和论坛帖子。