如何为开源社区编写治理流程文档

在开源社区中，我们经常讨论贡献指南、行为准则以及新贡献者引导。但我们很少讨论的一个话题是什么？治理。

治理听起来很严肃，但其核心含义很简单：我们如何做决策，以及谁来做决策？无论你是在基层项目与几位维护者合作，还是在一个成熟的开源生态系统中工作，治理流程都会影响人们如何贡献、管理问题以及成长为领导者。

而且，就像开源中的任何事情一样——如果没有文档记录，它可能就不存在。

在本文中，我将解释为什么治理文档很重要，应该包含哪些内容，以及如何编写有用、清晰且人性化的治理流程文档。

为什么治理很重要（以及为什么要文档化）

每个开源社区都已经有某种形式的治理（即使没有写下来）。有时是单个维护者做出所有决策，有时是一小群人“知道什么是最好的”。这里的危险不是结构本身，而是缺乏清晰度。

当治理流程没有文档化时：

文档化治理可以促进信任、透明度和可预测性。它并不意味着将贡献者限制在僵化的规则中，而是为社区提供对事物如何运作以及如何变化的共同理解。

将你的治理文档视为一张地图。它应该帮助贡献者理解他们所处的位置、事物如何运作以及他们可以采取哪些路径，包括：

治理文档不必读起来像法律政策。事实上，它不应该。清晰、友好的语气有助于读者感到被包容，特别是新来者或来自代表性不足群体的贡献者。

你在治理文档中使用的语气将塑造人们对社区的感受。它可能感觉像一扇锁着的门，也可能是一条清晰、友好的前进道路。以下是如何保持人性化：

我曾帮助在多年非正式的项目中编写治理文档。最难的部分？开始。总是担心越界或“让它太正式”。

但写下事情并不意味着一成不变。事实上，最好的治理文档是活文档，与社区共同创建，定期审查，并随着项目的发展而更新。

我学到的一些经验：

如果你不确定从哪里开始，可以参考那些做得好的开源项目。例如，Kubernetes 在其社区仓库中有一个结构良好的治理模型文档，概述了从角色到决策过程的一切。

Tor 项目也维护透明且社区驱动的治理文档（我曾有机会贡献的一个项目），定义了角色、职责和决策路径，并向世界各地的贡献者传达。

编写治理文档不必令人害怕。它只是让不可见的东西变得可见，并以邀请人们加入的方式完成。当你写下事物如何运作时，你为他人自信地贡献、理解他们加入的社区并在其中成长创造了空间。这就是治理应该关注的。

所以，如果你的项目还没有记录其治理原则，不要等到它“足够大”。现在就开始，从小处着手，让它与你的社区一起发展。

记住：治理不是关于控制，而是关于清晰。