> For the complete documentation index, see [llms.txt](https://freebsd-journal-cn.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://freebsd-journal-cn.bsdcn.org/20151112-qian-yi-jail-guan-li/growing-freebsd-contributors-with-the-doc-lounge-concept.md).

# 用 Doc Lounge 理念培养 FreeBSD 贡献者

* 原文：[Growing FreeBSD Contributors with the Doc Lounge Concept](https://freebsdfoundation.org/our-work/journal/browser-based-edition/migrating-jail-management-from-warden-to-iocage/)
* 作者：**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。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://freebsd-journal-cn.bsdcn.org/20151112-qian-yi-jail-guan-li/growing-freebsd-contributors-with-the-doc-lounge-concept.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.