菜单

项目治理和社区角色

相关源文件

本文档概述了tldr-pages项目的治理结构、社区角色和决策流程。它解释了贡献者如何根据他们的活动和贡献在不同角色之间晋升,确保了透明和绩效驱动的项目管理方法。有关为项目做出贡献的信息,请参阅为TLDR Pages做贡献

治理原则

tldr-pages项目遵循开放、欢迎和非层级式的治理模式。项目力求成为一个“行动至上”的组织,即角色反映实际的贡献,而不是通过自上而下的决策分配。

核心治理原则包括:

  • 开放的贡献:所有贡献,无论大小或复杂程度,都受到欢迎。
  • 尊重的互动:所有交流都必须尊重和友好。
  • 公开的交流:所有项目相关的讨论都应公开进行。
  • 基于共识的决策:决策通过社区共识做出。
  • 基于活动的角色:社区角色反映了贡献者执行的实际工作。

来源:GOVERNANCE.md COMMUNITY-ROLES.md

社区角色

tldr-pages项目拥有一个结构化的角色晋升体系,贡献者可以根据其活跃度和贡献来晋升。

仓库协作者

仓库协作者拥有tldr仓库的写入权限,这允许他们:

  • 标记、编辑和关闭issue/pull request
  • 审查和合并其他贡献者的pull request
  • 提交代码到仓库

要成为协作者,贡献者必须至少有5个有意义的pull request合并到仓库中。

组织成员

组织成员拥有tldr-pages组织内所有仓库的写入权限。除了协作者的权限外,他们还可以:

  • 提交代码到组织的所有仓库
  • 协助维护更广泛的项目基础设施

要成为组织成员,协作者必须至少提交10个PR并进行至少5次有意义的审查。所有组织成员必须公开其成员身份。

组织所有者

组织所有者拥有tldr-pages组织的管理权限,包括:

  • 将人员添加到组织
  • 管理组织的所有仓库
  • 配置集成
  • 在社区内执行角色变更

要成为组织所有者,成员必须保持活跃至少6个月。

来源:COMMUNITY-ROLES.md9-78 MAINTAINERS.md9-277

角色转换流程

tldr-pages项目的角色转换遵循一个透明且客观的流程,该流程基于可衡量的贡献。

提议角色变更

任何社区成员都可以通过以下步骤提议角色变更:

  1. 检查贡献者是否符合角色转换的标准。
  2. 使用适当的消息模板打开一个issue。
  3. 等待贡献者确认邀请。
  4. 授予与新角色相关的权限。
  5. 更新MAINTAINERS.md文件以反映变更。

处理不活跃成员

如果成员连续6个月以上不活跃,其成员身份将被停用。这并非惩罚,而是对其参与项目实际情况的反映。如果他们恢复活跃,可以将其重新添加到之前的角色。

来源:COMMUNITY-ROLES.md80-220

决策流程

tldr-pages项目依赖社区共识进行决策,遵循以下原则:

Pull Request 审查

  • PR在满足以下条件后应被合并:
    1. 通过自动化测试(GitHub Actions,CLA签名)
    2. 已解决审查评论
    3. 获得两名维护者的批准(第二位维护者批准后可立即合并)

审查分配

  • 对于非英语PR,至少应有一名来自对应语言CODEOWNERS的批准。
  • 如果PR未能获得审查,维护者应提醒其他人进行审查。
  • 如果PR作者未响应,维护者可以自行进行微小修改。

决策升级

  • 对于重大或破坏性更改,PR应标记为“decision”,并在聊天室中进行讨论。
  • 如果PR在超过一周内未获得第二名维护者的批准,则第一位维护者(如果是所有者)可以继续合并。

来源:contributing-guides/maintainers-guide.md56-103

CODEOWNERS 系统

CODEOWNERS 文件为在项目特定领域具有专长的贡献者自动分配审查请求。

拥有写入权限的贡献者可以自行添加到CODEOWNERS文件中,以便:

  • 获得特定文件或目录的自动审查请求。
  • 协助审查他们掌握语言的翻译。
  • 协助平台特定或文档审查。

此机制仅用于自动审查请求,不授予对所拥有代码文件的额外版权。

来源:.github/CODEOWNERS COMMUNITY-ROLES.md221-236

贡献者和维护者结构

tldr-pages项目的当前结构包含不同角色的多元化贡献者和维护者群体:

角色职责当前数量
仓库协作者审查PR,合并贡献,维护仓库30+ 活跃
组织成员维护所有仓库,更广泛的项目监督15+ 活跃
组织所有者管理权限,执行角色变更10+ 活跃

所有活跃的维护者都在MAINTAINERS.md中列出,该文件作为谁处于每个角色以及他们何时进入该角色的官方记录。

来源:MAINTAINERS.md

沟通渠道

项目的主要沟通渠道是:

  • GitHub Issues:用于bug报告、功能请求和页面请求。
  • Pull Requests:用于代码和文档贡献。
  • Matrix Chatroom:用于实时讨论和提问(可在 #tldr-pages:matrix.org 找到)。

所有关于项目的重要决策都通过这些公开渠道进行,以确保透明度并允许所有社区成员参与。

来源:GOVERNANCE.md34-42 README.md119

双因素认证要求

所有协作者和组织成员必须在其GitHub账户上启用双因素认证(2FA),才能被添加到tldr-pages组织。此要求有助于确保项目的安全。

来源:COMMUNITY-ROLES.md21-25