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 功能,选择要使用的功能,并记录决策。
特权
所有者可以
- 根据需要添加和删除组织所有者和成员。
- 根据需要添加和删除特定仓库的协作者。
- 根据需要添加仓库(作为新项目或转移项目)。
角色摘要
特殊角色
焦点贡献者
焦点贡献者是指在对 MDN Web Docs 的贡献中表现出色的人。他们的贡献形式包括通过拉取请求改进项目,在各种 交流渠道 或学习论坛上帮助社区成员,或在 GitHub 问题和拉取请求上提供反馈。
受邀专家
受邀专家在 MDN 上有贡献、参与讨论和评审的记录,或在某一专业领域有经过验证的知识。受邀专家负责 MDN 项目的特定主题领域或组件。他们负责评审和批准其主题或项目领域的拉取请求,回答技术问题,并维护其特定项目的整体健康状况。请参阅 流程 以提名某人成为受邀专家。
除了 组织成员 的职责外,受邀专家还负责:
- 遵循 评审指南。
- 评审其主题领域的拉取请求。
- 帮助其他贡献者成为评审员。
当其主题领域的拉取请求被打开时,受邀专家会被自动分配进行评审。如果一个主题领域有多名专家,他们将使用 负载均衡策略 分配到拉取请求。
依赖项
要符合受邀专家的资格,您必须满足以下一项或多项要求:
- 展示了对特定主题领域的深入知识。
- 承诺对其分配的主题领域负责。
- 支持新贡献者和偶尔贡献者,并帮助他们准备好拉取请求进行合并。
- 参加每两个月举行一次的社区会议。
特权
受邀专家被添加到 受邀专家团队 和适当的主题或项目团队。受邀专家可以:
- 访问所需的仓库以进行提交、拉取请求批准和合并。
- 推荐并投票选举其他成员成为受邀专家。
- 参加每周的 MDN Web Docs 编辑电话会议。
社区经理
社区经理在许多方面都扮演着独特的角色。社区经理与 维护者 有许多相同的职责。此外,社区经理还承担以下职责:
- 处理违反我们 行为准则(即 Mozilla 社区参与指南)的报告,并决定适当的行动。
- 组织和举办社区活动。
- 组织与社区相关的项目会议。
- 确定推广 MDN 项目的媒体策略。
- 定义和实施贡献者入门体验。
- 引导新贡献者和用户。
- 确保 MDN 项目和所有参与者的健康和福祉。
- 识别并协助实施自动化以提高项目可持续性。
- 与贡献者和合作伙伴会面并确保健康的合作关系。
- 酌情协助问题分类和拉取请求评审。
- 监控所有 交流渠道。
- 表彰在 MDN 项目中做出杰出贡献和/或表现出奉献精神的贡献者。
流程
提名维护者
请参阅谁可以成为 维护者。
要提名某人成为维护者,请在 GitHub 上创建一个问题:
- 在
mdn/mdn仓库的Issues选项卡上,点击右侧的 New issue 按钮。 - 在“Nominate a maintainer”(提名维护者)下,点击 Get started(开始)按钮。
- 填写表格,详细说明您所提名人的贡献,然后提交表格。
提名焦点贡献者
请参阅谁可以成为 焦点贡献者。
要提名某人成为焦点贡献者,请在 GitHub 上创建一个问题:
- 在
mdn/mdn仓库的Issues选项卡上,点击右侧的 New issue 按钮。 - 在“提名焦点贡献者”下,点击“开始”按钮。
- 填写表格,详细说明您所提名人的贡献,然后提交表格。
MDN 团队将与被提名人联系,以获取其信息,并将其发布在 网站 的“焦点贡献者”部分。
提名受邀专家
请参阅谁可以成为 受邀专家。
要提名某人成为受邀专家,请在 GitHub 上创建一个问题:
- 在
mdn/mdn仓库的Issues选项卡上,点击右侧的 New issue 按钮。 - 在“提名受邀专家”下,点击“开始”按钮。
- 填写表格,详细说明您所提名人的贡献,然后提交表格。
卸任或申请荣誉身份
生活瞬息万变,您作为贡献者的承诺水平可能会随着时间而改变。根据您的情况,您可能希望:
- 暂时中断项目。
- 降级到要求较低的角色。
- 完全退出项目(申请荣誉身份)。
在所有这些情况下,请随时与 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。
- 针对不同的主题领域设有子团队——无障碍、附加组件、CSS、HTML、HTTP、JavaScript、SVG、Web API 和 WebAssembly。例如,有
要成为团队成员,您必须:
联系 MDN 团队
如有疑问和反馈,请联系 mdn-web-docs-community (at) mozilla (.com)。