这周我得到一个很棒的想法——文档冲刺!我一直在为我的书的第二版做案例研究,书名是《对话与社区:文档的社交网络》,在 Atlassian 的 Sarah Maddox 的一个案例研究中,我发现了一个绝妙的点子。
来自 Sarah
我们也举办过几次文档冲刺测试。这是一种非常有效的方式,可以在发布日期之前让开发和支持团队参与到文档测试中。技术作者会制定一个计划,包括要重点关注的文档列表以及人们提供反馈的几种方式。我们通常会包括一个 IRC 频道,以及 wiki 页面和评论,以便工程师可以选择最适合他们的方式。我们会分配一个时间段,通常只有一小时,每个人都会投入到文档中。聊天会非常活跃,评论会飞速涌现,最终我们会得到很多有用的反馈。
我非常喜欢这个想法,并希望在 OpenStack 中尝试一下。幸运的是,时机正好,Diablo 版本将于 9 月 22 日发布。
9 月 19 日星期一,下午 2:00-3:00 CST(2011 年 9 月 19 日星期一 17:00:00)
- 在 https://docs.openstack.org/docblitz 上添加文档页面的评论(我将在星期一开放这些页面)。
- 在 #openstack IRC 频道 中讨论你的发现。
- 使用 #docblitz 标签发送一条推文。
- 在 https://bugs.launchpad.net/openstack-manuals 上记录一个文档错误。
为了覆盖全球另一侧,我们将在 9 月 20 日晚上 11:00-12:00 CST(2011 年 9 月 20 日星期二 04:00:00)再次运行文档冲刺一个小时。
让我们去寻找文档错误吧!
发表回复