本文档概述了tldr-pages项目的治理结构、社区角色和决策流程。它解释了贡献者如何根据他们的活动和贡献在不同角色之间晋升,确保了透明和绩效驱动的项目管理方法。有关为项目做出贡献的信息,请参阅为TLDR Pages做贡献。
tldr-pages项目遵循开放、欢迎和非层级式的治理模式。项目力求成为一个“行动至上”的组织,即角色反映实际的贡献,而不是通过自上而下的决策分配。
核心治理原则包括:
来源:GOVERNANCE.md COMMUNITY-ROLES.md
tldr-pages项目拥有一个结构化的角色晋升体系,贡献者可以根据其活跃度和贡献来晋升。
仓库协作者拥有tldr仓库的写入权限,这允许他们:
要成为协作者,贡献者必须至少有5个有意义的pull request合并到仓库中。
组织成员拥有tldr-pages组织内所有仓库的写入权限。除了协作者的权限外,他们还可以:
要成为组织成员,协作者必须至少提交10个PR并进行至少5次有意义的审查。所有组织成员必须公开其成员身份。
组织所有者拥有tldr-pages组织的管理权限,包括:
要成为组织所有者,成员必须保持活跃至少6个月。
来源:COMMUNITY-ROLES.md9-78 MAINTAINERS.md9-277
tldr-pages项目的角色转换遵循一个透明且客观的流程,该流程基于可衡量的贡献。
任何社区成员都可以通过以下步骤提议角色变更:
如果成员连续6个月以上不活跃,其成员身份将被停用。这并非惩罚,而是对其参与项目实际情况的反映。如果他们恢复活跃,可以将其重新添加到之前的角色。
tldr-pages项目依赖社区共识进行决策,遵循以下原则:
来源:contributing-guides/maintainers-guide.md56-103
CODEOWNERS 文件为在项目特定领域具有专长的贡献者自动分配审查请求。
拥有写入权限的贡献者可以自行添加到CODEOWNERS文件中,以便:
此机制仅用于自动审查请求,不授予对所拥有代码文件的额外版权。
来源:.github/CODEOWNERS COMMUNITY-ROLES.md221-236
tldr-pages项目的当前结构包含不同角色的多元化贡献者和维护者群体:
| 角色 | 职责 | 当前数量 |
|---|---|---|
| 仓库协作者 | 审查PR,合并贡献,维护仓库 | 30+ 活跃 |
| 组织成员 | 维护所有仓库,更广泛的项目监督 | 15+ 活跃 |
| 组织所有者 | 管理权限,执行角色变更 | 10+ 活跃 |
所有活跃的维护者都在MAINTAINERS.md中列出,该文件作为谁处于每个角色以及他们何时进入该角色的官方记录。
项目的主要沟通渠道是:
#tldr-pages:matrix.org 找到)。所有关于项目的重要决策都通过这些公开渠道进行,以确保透明度并允许所有社区成员参与。
来源:GOVERNANCE.md34-42 README.md119
所有协作者和组织成员必须在其GitHub账户上启用双因素认证(2FA),才能被添加到tldr-pages组织。此要求有助于确保项目的安全。