此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

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)。