MDN Web 文档角色和团队

MDN Web 文档项目的成功和发展在很大程度上要归功于我们的贡献者社区。一些贡献者投入了部分时间,协助完成 MDN Web 文档的日常运行任务。对网站的修改,包括维护任务,都是由员工、承包商和合作伙伴网络完成的,他们都致力于 MDN Web 文档的健康、发展和维护。该项目在很大程度上依赖于 GitHub 上的 MDN 组织中的角色团队来管理和整合来自这些不同群体的变更。该组织的成员名单可在此找到

社区贡献对这个开源项目帮助巨大。贡献者可以通过他们在 MDN Web 文档上的工作展示他们的写作、技术和协作技能,以及与来自不同背景的人合作的能力。本节将介绍你在 MDN Web 文档项目志愿工作中可以担任的角色。

角色

在 MDN Web 文档项目中,你可以担任贡献者组织成员维护者所有者角色。从一个角色到下一个角色是一个循序渐进的过程。随着职责的提升,你可以同时担任多个角色。如果你在某一特定领域表现出专业知识,就可以直接获得特邀专家等角色。

无论在这个项目中担任什么样的角色,你总是一名贡献者贡献者是最基本的角色,所有其他角色都建立在其基础之上。因此,在以任何身份参与本项目时,都必须满足贡献者角色的要求。

贡献者

贡献者,或社区参与者,用他们的时间、技能、意见和想法为项目添砖加瓦。他们直接参与项目工作,并为项目增添价值。除了撰写并测试代码外,创建和更新文档、调查研究、修复缺陷和帮助其他社区成员都是贡献的一种。

根据贡献频率不同,你可以是偶尔贡献的人,也可以是积极贡献的人。如果你对项目产生了重大影响,可能会被提名为杰出贡献者或晋升为组织成员

如果你是新人,并且想成为一名贡献者,可以看看我们的贡献指南MDN GitHub 组织中的仓库列表

作为一名贡献者,你可以通过参与以下活动来参与该项目:

  • 沟通渠道中参与社区讨论。
  • 帮助其他贡献者处理拉取请求和问题,或指导新贡献者。
  • 提交缺陷报告。查看 MDN content 仓库中你可以提出议题的类型。如果你发现了平台的缺陷,你可以在 MDN 的 yari 仓库中提出议题
  • 对问题发表评论,推动对话取得丰硕成果。
  • 通过提交拉取请求来解决开启的议题(例如,在 content 仓库中)。
  • 参与社区活动。
  • 帮助推荐 MDN 项目。

要求:

如果想要成为一名贡献者,你需要遵循:

权利:

贡献者可以获得以下权利:

  • 获得贡献者活动的邀请。
  • 有资格成为组织成员

组织成员

组织成员是受到认可的贡献者,他们定期参与 MDN Web 文档项目并作出贡献。他们的行为应符合项目的利益。

要求:

如果想要成为一名组织成员,你必须至少满足以下需求之一:

  • 开启了至少两个拉取请求并获得合并,它们解决了至少两个议题。
  • 已经为 MDN Web 文档项目贡献了至少两个月。
  • 至少为一个项目领域做出了积极贡献。

以下两个要求是必须满足的:

权利:

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

维护者

维护者是受到认可的贡献者,他们对 MDN 上的至少一个项目负责。他们应参与项目政策和优先事项的决策。请参阅流程以提名维护者。

作为一名维护者,你会参与到以下活动中:

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

要求:

你必须满足以下一项或多项要求,才有资格成为维护者:

  • 担任特邀专家至少六个月。
  • 展示了对项目多个领域的广泛了解。
  • 证明有能力独立于其他成员的影响,为项目的利益做出判断。
  • 具备指导其他贡献者的素质。
  • 同意承诺每月为项目工作至少 16 个小时。
  • 参加每两个月一次的社区会议。

备注: 如果你认为有人有资格担任此角色,可以提名维护者

权利:

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

所有者

所有者拥有管理用户和 GitHub 团队、维护 MDN 组织中各仓库的访问权限、维护仓库设置以及部署到生产环境的广泛权限。所有者受其他贡献者角色的所有要求约束。

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

要求:

  • 遵守并执行 MDN 团队规范,包括社区参与准则Mozilla 政策
  • 遵守 MDN 组织政策并以身作则。
  • 通过拉取请求过程建议、记录和实施新政策。
  • 关注并参与整个 MDN 组织的问题和讨论。
  • 确保问题或拉动请求在一周内得到一名或多名成员的反馈。
  • 归档或删除未维护的软件源。
  • 讨论 GitHub 功能,选择要使用的功能,并将决定记录在案。

权利:

所有者可以:

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

角色总结

角色 需求 权利
贡献者 遵守行为准则和贡献准则 - 受邀请参加贡献者活动
- 有资格成为组织成员
组织成员 - 在 GitHub 账户上启用双因素身份验证(2FA)
- 启用签名提交

至少一个:
- 解决至少两个议题
- 至少贡献了两个月
- 在一个项目领域作出活跃贡献
组织级别的访问权限
维护者 至少一个:
- 担任特邀专家至少六个月
- 了解多个项目领域
- 为项目的整体健康采取行动
- 指导其他贡献者
- 每月至少在项目中花费 16 小时
- 出席社区会议
批准并合并拉取请求
所有者 仅限 Mozilla 员工 - 管理各种仓库的不同角色权限
- 添加或归档仓库和项目

特殊的角色

有些贡献者角色的职责更为细化,并有特殊的资格条件。这些角色包括杰出贡献者特邀专家社区管理员

杰出贡献者

杰出贡献者是那些对 MDN Web 文档做出了卓越贡献的人。他们的贡献形式包括:提出拉取请求以改进项目;在各种沟通渠道或学习论坛上帮助社区成员;或就 GitHub 问题和拉取请求提供反馈。

我们每月在 MDN 网站上介绍一位杰出贡献者。请参见流程,提名某人为杰出贡献者。

特邀专家

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

除了作为组织成员的职责外,特邀专家还需要:

  • 遵循审查指南
  • 审查有关他们研究主题下的拉取请求。
  • 帮助其他贡献者成为审查员。

当拉取请求在受邀专家的主题领域被提出时,会自动分配专家进行审查。如果一个主题领域有多个专家,则会使用负载平衡策略

要求:

如果想要成为一名特邀专家,你必须至少满足以下需求之一:

  • 展示了对特定专题领域的深入了解。
  • 承诺对指定的主题领域负责。
  • 支持新的和偶尔加入的贡献者,并帮助拉取请求做好合并准备。
  • 参加每两个月一次的社区会议。

权利:

受邀专家会被添加到受邀专家团队以及相应的专题或项目团队中。受邀专家可以:

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

社区管理员

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

  • 处理有关违反 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. 在“Nominate a spotlight contributor”(提名杰出贡献者)下,点击 Get Started 按钮。
  3. 在表单中填写你要提名的人员的贡献细节并提交表单。

MDN 团队将会联系被提名的人,以获得在网站“Contributor Spotlight”栏目下发布的必要信息。

提名特邀专家

查看作为特邀专家的条件。

想要提名某人为特邀专家,在 GitHub 上开启议题:

  1. mdn/mdn 仓库的 Issues 选项卡中,点击右侧的 New issue 按钮。
  2. 在“Nominate an invited expert”(提名特邀专家)下,点击 Get Started 按钮。
  3. 在表单中填写你要提名的人员的贡献细节并提交表单。

卸任或申请名誉身份

生活中会发生很多事情,作为贡献者,你的承诺水平可能会随着时间的推移而发生变化。根据你的情况,可能需要:

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

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

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

如果未能履行责任和达到要求,包括多次不活跃或违反行为准则,贡献者可能会被降级或除名。

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

删除不活跃的贡献者可以保护项目及其交付成果,同时也为新贡献者的加入提供了机会。

我们将“不活跃”定义为:

  • 在六个月内没有为项目做过贡献。
  • 至少三个月没有应答联系。

不活跃会对项目造成损害;它可能导致意想不到的延误、贡献者流失以及对项目失去信任。贡献者必须保持活跃,以树立榜样并表明对项目的承诺。

如果时间承诺发生变化,请与社区团队沟通以避免降级或撤职,也可以主动选择暂时退出或转为荣誉身份

团队

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

  • 团队中的成员会根据他们相关的领域被添加到 CODEOWNERS 文件中。
  • 当拉取请求对你相关领域的文件作出改动时,GitHub 会基于 CODEOWNERS 文件,使用负载均衡算法自动将你添加为拉取请求的审阅者。
  • 团队中的成员拥有更高级别的仓库访问权限。仓库权限只分配给成员需要访问的仓库。

MDN GitHub 组织包含这些团队:

  • @Core:MDN Web 文档核心团队

  • @mdn-community-engagement:负责我们所有仓库的社区参与的成员

  • @mdn-product:负责 MDN Plus 产品的成员

  • @localization-team-leads:领导我们各个本地化团队的成员

  • @OWD:来自 Open Web Docs 非营利组织的贡献者

  • @sre:支持 MDN Web 文档网站可靠性的工程师

  • @yari-content:MDN Web 文档所有的内容审查团队的总称

    • 在不同的领域下,如无障碍、插件、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)。