MDN Web Docs 角色和团队

MDN Web Docs 项目的成功和发展,在很大程度上归功于我们的贡献者社区。一些贡献者投入了一部分时间来协助处理 MDN Web Docs 的日常任务。网站的变更,包括维护任务,由员工、承包商以及致力于 MDN Web Docs 健康、发展和维护的合作伙伴网络共同完成。该项目严重依赖 角色团队GitHub 上的 MDN 组织 中管理和整合来自这些不同群体的变更。可以在 github.com/orgs/mdn 找到组织当前成员的列表。

社区贡献对这个开源项目帮助巨大。贡献者可以在 MDN Web Docs 上展示他们的写作、技术和协作技能,以及与来自不同背景的人合作的能力。本节描述了在 MDN Web Docs 项目中志愿服务时可以承担的角色。

角色

在 MDN Web Docs 项目中,您可以扮演 贡献者组织成员维护者所有者 的角色。从一个角色到下一个角色的进展是一个循序渐进的过程。随着您责任的增加,您可能同时担任多个角色。如果您在特定领域展示了专业知识,可以直接获得 受邀专家 等角色。

无论您在这个项目中扮演什么角色,您始终是 贡献者贡献者 是基础角色,所有其他角色都建立在此之上。因此,在以任何身份参与此项目时,您都必须满足贡献者角色的要求。

贡献者

贡献者,或称社区参与者,通过他们的时间、技能、意见和想法为项目做出贡献。贡献者直接参与项目并为其增加价值。除了编写和测试代码,贡献还包括创建和更新文档、研究、修复错误以及帮助其他社区成员。

根据您贡献的频率,您可以是偶尔贡献的人,也可以是活跃的贡献者。如果您对项目产生了巨大影响,您可能会被提名为 焦点贡献者 或晋升为 组织成员

如果您是新手,并希望成为贡献者,请查看我们的 入门指南MDN GitHub 组织中的仓库

作为贡献者,您可以通过以下活动参与项目:

  • 交流渠道 上参与社区讨论。
  • 帮助其他贡献者处理他们的拉取请求和问题,或指导新贡献者。
  • 提交错误报告。有关更多信息,请查看 主要仓库
  • 在问题上发表评论,以促使对话达成富有成效的解决方案。
  • 通过提交 拉取请求 来解决未决问题(例如,在 content 仓库中)。
  • 参加社区活动。
  • 帮助推广 MDN 项目。

依赖项

要成为贡献者,您必须遵守

  • Mozilla 的行为准则
  • 每个仓库的具体指南。如果项目有任何特定的提示或指南,您将在项目仓库根目录的 CONTRIBUTING.md 文件中找到它们。

特权

贡献者享有以下特权:

  • 受邀参加贡献者活动。
  • 有资格成为 组织成员

组织成员

组织成员 是定期参与并贡献 MDN Web Docs 项目的成熟 贡献者。他们被期望以项目的利益行事。

依赖项

要成为组织成员,您必须满足以下一项或多项要求:

  • 已发起两个或更多已合并的拉取请求,解决了两个或更多问题。
  • 为 MDN Web Docs 项目贡献至少两个月。
  • 至少在一个项目领域积极贡献。

以下两项要求是强制性的:

特权

组织成员在 GitHub 上拥有 组织级别 的特权。

维护者

维护者是MDN上负责一个或多个项目的成熟贡献者。他们被期望参与项目的政策和优先级的决策。请参阅提名某人成为维护者的流程

作为维护者,您参与以下活动:

  • 确定您负责的项目的优先级。
  • 参与社区会议。
  • 指导所有其他角色的新老贡献者。
  • 根据技能集,在您的项目领域提出、批准或实施
    • 代码和基础设施改进
    • 内容改进
    • 流程改进

依赖项

要符合维护者的资格,您必须满足以下一项或多项要求:

  • 作为 受邀专家 积累了至少六个月的经验。
  • 在多个项目领域展示了广泛的知识。
  • 展示了独立于其他成员的影响力,为项目利益做出判断的能力。
  • 展现了指导其他贡献者的品质。
  • 同意每月至少花费 16 小时在项目上。
  • 参加每两个月举行一次的社区会议。

注意:如果您认为某人符合此角色的资格,您可以 提名维护者

特权

维护者有权批准和合并拉取请求。

所有者

所有者拥有广泛的权限,可以管理用户和 GitHub 团队,维护 MDN 组织 中跨仓库的访问权限,维护仓库设置,以及部署到生产环境。所有者必须遵守所有其他贡献者角色的要求。

注意:所有者角色目前仅限于 Mozilla 员工。

依赖项

除了其他贡献者角色的职责外,所有者还承担以下职责:

  • 遵循并执行 MDN 团队规范,包括 社区参与指南Mozilla 政策
  • 遵循 MDN 组织政策并以身作则。
  • 通过 拉取请求流程 建议、记录和实施新政策。
  • 关注并为 MDN 组织中的问题和讨论做出贡献。
  • 确保问题或拉取请求在一周内得到一名或多名成员的反馈。
  • 存档 或删除未维护的仓库。
  • 讨论 GitHub 功能,选择要使用的功能,并记录决策。

特权

所有者可以

  • 根据需要添加和删除组织所有者和成员。
  • 根据需要添加和删除特定仓库的协作者。
  • 根据需要添加仓库(作为新项目或转移项目)。

角色摘要

角色 依赖项 特权
贡献者 遵循行为准则和贡献指南 - 邀请参加贡献者活动
- 有资格成为组织成员
组织成员 - 为 GitHub 账户启用双重认证 (2FA)
- 启用签名提交

以下一项或多项:
- 解决两个或更多问题
- 贡献至少两个月
- 在项目领域活跃贡献
组织级别的访问权限
维护者 以下一项或多项:
- 担任受邀专家至少六个月
- 拥有多个项目领域的知识
- 为项目的整体健康而努力
- 指导其他贡献者
- 每月在项目上花费至少 16 小时
- 参加社区会议
批准和合并拉取请求
所有者 限于 Mozilla 员工 - 管理不同角色对各种仓库的访问
- 添加或归档仓库和项目

特殊角色

某些贡献者角色具有更细致的职责和特殊的资格条件。其中包括 焦点贡献者受邀专家社区经理

焦点贡献者

焦点贡献者是指在对 MDN Web Docs 的贡献中表现出色的人。他们的贡献形式包括通过拉取请求改进项目,在各种 交流渠道 或学习论坛上帮助社区成员,或在 GitHub 问题和拉取请求上提供反馈。

我们每月都会在 MDN 网站 上推出一位焦点贡献者。请参阅 流程 以提名某人成为焦点贡献者。

受邀专家

受邀专家在 MDN 上有贡献、参与讨论和评审的记录,或在某一专业领域有经过验证的知识。受邀专家负责 MDN 项目的特定主题领域或组件。他们负责评审和批准其主题或项目领域的拉取请求,回答技术问题,并维护其特定项目的整体健康状况。请参阅 流程 以提名某人成为受邀专家。

除了 组织成员 的职责外,受邀专家还负责:

  • 遵循 评审指南
  • 评审其主题领域的拉取请求。
  • 帮助其他贡献者成为评审员。

当其主题领域的拉取请求被打开时,受邀专家会被自动分配进行评审。如果一个主题领域有多名专家,他们将使用 负载均衡策略 分配到拉取请求。

依赖项

要符合受邀专家的资格,您必须满足以下一项或多项要求:

  • 展示了对特定主题领域的深入知识。
  • 承诺对其分配的主题领域负责。
  • 支持新贡献者和偶尔贡献者,并帮助他们准备好拉取请求进行合并。
  • 参加每两个月举行一次的社区会议。

特权

受邀专家被添加到 受邀专家团队 和适当的主题或项目团队。受邀专家可以:

  • 访问所需的仓库以进行提交、拉取请求批准和合并。
  • 推荐并投票选举其他成员成为受邀专家。
  • 参加每周的 MDN Web Docs 编辑电话会议。

社区经理

社区经理在许多方面都扮演着独特的角色。社区经理与 维护者 有许多相同的职责。此外,社区经理还承担以下职责:

  • 处理违反我们 行为准则(即 Mozilla 社区参与指南)的报告,并决定适当的行动。
  • 组织和举办社区活动。
  • 组织与社区相关的项目会议。
  • 确定推广 MDN 项目的媒体策略。
  • 定义和实施贡献者入门体验。
  • 引导新贡献者和用户。
  • 确保 MDN 项目和所有参与者的健康和福祉。
  • 识别并协助实施自动化以提高项目可持续性。
  • 与贡献者和合作伙伴会面并确保健康的合作关系。
  • 酌情协助问题分类和拉取请求评审。
  • 监控所有 交流渠道
  • 表彰在 MDN 项目中做出杰出贡献和/或表现出奉献精神的贡献者。

流程

提名维护者

请参阅谁可以成为 维护者

要提名某人成为维护者,请在 GitHub 上创建一个问题:

  1. mdn/mdn 仓库的 Issues 选项卡上,点击右侧的 New issue 按钮。
  2. 在“Nominate a maintainer”(提名维护者)下,点击 Get started(开始)按钮。
  3. 填写表格,详细说明您所提名人的贡献,然后提交表格。

提名焦点贡献者

请参阅谁可以成为 焦点贡献者

要提名某人成为焦点贡献者,请在 GitHub 上创建一个问题:

  1. mdn/mdn 仓库的 Issues 选项卡上,点击右侧的 New issue 按钮。
  2. 在“提名焦点贡献者”下,点击“开始”按钮。
  3. 填写表格,详细说明您所提名人的贡献,然后提交表格。

MDN 团队将与被提名人联系,以获取其信息,并将其发布在 网站 的“焦点贡献者”部分。

提名受邀专家

请参阅谁可以成为 受邀专家

要提名某人成为受邀专家,请在 GitHub 上创建一个问题:

  1. mdn/mdn 仓库的 Issues 选项卡上,点击右侧的 New issue 按钮。
  2. 在“提名受邀专家”下,点击“开始”按钮。
  3. 填写表格,详细说明您所提名人的贡献,然后提交表格。

卸任或申请荣誉身份

生活瞬息万变,您作为贡献者的承诺水平可能会随着时间而改变。根据您的情况,您可能希望:

  • 暂时中断项目。
  • 降级到要求较低的角色。
  • 完全退出项目(申请荣誉身份)。

在所有这些情况下,请随时与 MDN 团队 讨论您的情况和当前的承诺水平。

降级或移除不活跃的贡献者

当贡献者未能履行职责和要求时,包括重复的不活跃模式或违反 行为准则 时,可以将其降级或移除。

在维护者会议期间,参与者会提出降级或移除贡献者的建议。参与者会提供支持降级或移除请求的信息。经过讨论后,维护者和社区经理会就此事进行投票以做出决定。

移除不活跃的贡献者可以保护项目及其成果,也为新贡献者提供了参与的机会。

我们对不活跃的定义是:

  • 至少六个月内没有对项目做出贡献。
  • 至少三个月内没有回复沟通。

不活跃会损害项目;它可能导致意外延迟、贡献者流失以及对项目信任的丧失。贡献者必须保持活跃,以树立榜样并展现对项目的承诺。

如果您的时间承诺发生变化,请与社区团队沟通,以避免降级或移除;相反,您可以主动选择 暂时卸任或转为荣誉身份

团队

我们使用 GitHub 团队 功能来管理团队。当您被添加到团队时,这意味着您已经表达了更紧密地参与项目的意愿。这也意味着您拥有一些额外的职责和权利,如下所述:

  • 团队成员通常会根据其感兴趣的相应主题领域被添加到 CODEOWNERS 文件中。

  • 当拉取请求触及您负责的区域中的文件时,根据 CODEOWNERS 文件,您将使用 GitHub 的 负载均衡算法 自动添加为拉取请求的审阅者。

  • 团队成员拥有更高级别的仓库访问权限。仓库权限仅分配给成员需要访问的那些仓库。

MDN GitHub 组织 中的团队包括:

  • @Core:MDN Web Docs 核心团队
  • @mdn-community-engagement:负责我们所有仓库的社区参与人员
  • @mdn-product:负责 MDN Plus 产品的人员
  • @localization-team-leads:领导我们各个本地化团队的人员
  • @OWD:来自开放网络文档非营利组织的贡献者
  • @sre:支持 MDN Web Docs 的站点可靠性工程师
  • @yari-content:所有 MDN Web Docs 内容审阅者的总团队
    • 针对不同的主题领域设有子团队——无障碍、附加组件、CSS、HTML、HTTP、JavaScript、SVG、Web API 和 WebAssembly。例如,有 @yari-content-css@yari-content-svg
    • 还有针对不同语言的子团队——巴西葡萄牙语、中文、法语、日语、韩语、俄语和西班牙语。例如,有 @yari-content-fr@yari-content-ko

要成为团队成员,您必须:

联系 MDN 团队

如有疑问和反馈,请联系 mdn-web-docs-community (at) mozilla (.com)。