用 Doc Lounge 理念培养 FreeBSD 贡献者
作者：Warren Block
许多 FreeBSD 会议和活动都设有“hacker lounge”——一个供大家协同开展项目的大房间。这类房间很受欢迎，全天任何时段都有大量参与者。但对初来乍到者而言，那里可能嘈杂且令人望而生畏。
害羞、低调又内秀的文档组发现在 hacker lounge 里开展工作并不容易，于是考虑晚上在自己的房间里单独聚会。Dru Lavigne 进一步提出，不仅可以在不同的房间举办，还可以邀请任何对文档感兴趣的人参加。如果他们想学习如何修复错误、了解文档工具链的工作原理，或任何关于 FreeBSD 文档的事情，我们都会与他们一起合作。
起初我对此持怀疑态度。有人认为文档同仁应该和源代码组待在一起：文档是程序的一部分，理应同等对待，而非事后的补救。hacker lounge 的噪音确实让人难以在那里工作，即便只有文档组参加 doc lounge，我们也仍有许多事情可做。
但事情并未按担忧的方向发展。即便几乎没什么宣传，人们还是来了。他们坐下，耐心等待与一位文档开发者或 committer 交流，并在随后几晚再次出现。问题在于我们的人手不足以与每一位感兴趣的人合作。
过去几年里，形式从单纯的开放讨论演变为：每晚给全体做一两次简短的展示。这改变了群体氛围，也提供了变化。我们尽量把每次展示控制在 10 到 15 分钟，然后再回到小组形式。
从零开始一项新事物，远比在已有基础上修改要难。我把这称为“门槛效应”，在许多领域都一样。新手很难判断哪些是必需的、哪些是可选的，以及如何排定顺序。这也是编程中有标准“Hello World”示例的原因——它演示了最低限度所需，省去了可能造成干扰的细节。多数人需要的只是一点帮助他们跨过这道门槛。能有人在身旁指出哪些事情重要、并帮助避开沿途的小坑，这是莫大的安慰。
有些演示无非是如何检出文档、做一处小修改、生成补丁并提交。这对 committer 来说是简单的事，但对多数新用户而言至少有几分陌生。与乏味相反，新手对此兴致盎然。在 BSDCan 2015 上，他们指出文档流程中存在的一个 bug；修复它并提交改动就成了那次演示的一部分。
潜在译者是出现在 doc lounge 的另一类人群。他们都是技艺娴熟的人，能以至少两种语言从事技术工作。他们出现是因为对翻译 FreeBSD 文档、让更多人能读到这些资料感兴趣。过去我们一直难以轻松接受他们提供的帮助：传统翻译系统对临时贡献者来说耗时费力，有时甚至连专职译者都难以承受。我们新的 PO 翻译工具链大幅降低了翻译工作量，当有人愿意贡献翻译技能时，我们现在能让他们顺利上手。
doc lounge 还吸引来程序员、系统管理员、学生以及其他未必对文档本身感兴趣的人。他们更想通过观察文档部分如何运转，来体会整个项目如何运作。有些人只是对 FreeBSD 好奇，却被 hacker lounge 的规模与喧嚣所劝退。没有人引荐很难融入那个群体，但害羞、低调又内秀的文档组就显得不那么令人生畏了。
唯一的问题是我们通常没有足够的 FreeBSD 开发者和 committer 来与所有感兴趣的人合作。从两边看都可以理解：参加了一整天的会议或活动之后，人们都已疲倦；而与 FreeBSD 新手合作需要大量时间和耐心，并非每个人都具备相应的性情或经验。但付出终有回报——这种对 FreeBSD 的亲身引荐，会催生日后成长为开发者和 committer 的贡献者。
我们希望能有更多 FreeBSD 开发者和文档 committer 参加 doc lounge，这样我们才能更好地宣传它，吸引更多感兴趣的人，并有机会与所有人合作。
doc lounge 在 BSDCan（http://www.bsdcan.org）和 vBSDCon（http://vbsdcon.com）举办，也可以在其他活动中举办。我们诚邀会议组织者提供一个房间，欢迎与会者前来参与或协助。•
WARREN BLOCK 自 1998 年起使用 FreeBSD，自 2011 年起担任文档 committer。
最后更新于