为你的开源项目举办一场文档马拉松

文档马拉松是为你的开源项目制作或改进文档的一个好方法。

你的开源项目的文档对你的客户至关重要。你的目标受众必须了解你的项目的目的和如何使用它，而文档是弥合这一差距的工具。一个项目很少有真正完成的时候，所以随着你项目的不断改进，资源的维护和更新同样重要。

但是，当你有大量的文档需要维护，但又缺乏资源来保持它的时效性时，会发生什么？答案很简单：举办一个 文档马拉松 docathon ！

什么是文档马拉松？

文档马拉松就像 黑客马拉松 hackathon 。黑客马拉松是工程师和社区领袖聚集在一起改进或添加新功能到一个现有的应用的活动。在一个文档马拉松中，同样的合作集中在改进文档上。

文档马拉松可以填补内容上的空白，重组大型文档集，修复失效的链接，或者只是纠正错别字。举办文档马拉松的目的是为了在相对短的时间内改进大量的文档。

一些产品文档的例子包括：

• 培训手册
• 用户手册
• 安装指南
• 故障排除指南
• 快速入门指南
• API 文档
• 教程

在我的组织里，我们的文档团队举办了一次文档马拉松，成功地修改了 102 页的安装指南。这次文档马拉松使我们能够专注于项目的范围，即重新组织简化，删除重复的内容，并遵循客户旅程。举办文档马拉松给我的团队留下了深刻的印象，并提高了客户的成功率。

3 件你可以通过文档马拉松实现的事情

以下是我举办文档马拉松的三大理由：

1、减少积压

大多数文档必须随着它所支持的产品的发展而发展。随着产品的变化或更新，文档也必须如此。在某些情况下，文档团队与工程团队的发布周期一起发布新版本的文档。随着团队内优先级的改变和 GA 发布 的继续，文档团队面临着跟上新功能、错误修复和任务完成的挑战。被遗弃的变化成为积压的一部分，一种需要在以后完成的工作的积累。

提示： 在文档马拉松期间，参与者可以对积压的项目进行分流，并在列表中完成它们。非技术性的参与者可以从事与错别字、失效的链接和其他文本相关问题的修复工作。

2、改造大型指南

当你的文档团队意识到是时候修改指南的时候，它可能已经有好几章，好几百页了。一旦制定了内容计划，重组的复杂性就开始了。重组大量的文档并不适合胆小的人。

提示： 组建一个团队来领导文档马拉松，并为不同团队或部门的全组织参与提供奖励。根据工作范围和时间限制，你的团队可以在比你预期更短的时间内成功重组整个指南。

3、跨职能团队之间的合作

一个组织内的不同小组孤立地工作是很常见的。工程、产品、客户支持、营销和文档团队可能没有像他们应该的那样经常在项目上进行协作。

想象一下，举办一次活动，每个团队成员都可以利用他们的专业知识来改善产品文档。文档马拉松促进了主题专家（SME）的多样性、实时协作和沟通。它们还允许一个包容性的环境，居住在不同地理位置的人可以亲自或远程参与。你的文件会得到具有不同观点和专业的专家的关注，最大限度地减少孤立的孤岛、无意识的偏见和倦怠。

提示： 使跨职能的团队为了一个共同的事业走到一起。

文档马拉松

下一次，当你的团队有一个似乎无法克服的积压工作，或者被赋予重组一个巨大的文档项目的任务时，考虑举办一个文档马拉松。这很容易，而且它的生产力可能会让你吃惊。关于举办这样的活动的更多信息，请阅读 Tiffany Long 写的很棒的 举办黑客马拉松的 10 步指南。

（题图：MJ/1284f6fb-91e9-4799-8773-ee7f51fd87c9）

via: https://opensource.com/article/23/4/open-source-docathon

作者：Lydie Modé-Malivert 选题：lkxed 译者：geekpi 校对：wxy

本文由 LCTT 原创编译，Linux中国 荣誉推出

本文转载来自 Linux 中国: https://github.com/Linux-CN/archive