MDN 网页文档角色和团队

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

社区贡献对这个开源项目帮助很大。贡献者可以使用他们在 MDN 网页文档上的工作来展示他们的写作、技术和协作技能,以及与来自不同背景的人合作的能力。本节介绍你在志愿参与 MDN 网页文档项目时可以承担的角色。

角色

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

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

贡献者

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

根据你贡献的频率,你可以是一名偶尔贡献者或一名活跃贡献者。如果你对项目产生了重大影响,你可能会被提名为 亮点贡献者 或被提升为 组织成员.

如果你刚接触这里,并且想要成为贡献者,请查看我们的 贡献指南MDN GitHub 组织中的代码库.

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

  • 参与 沟通渠道 上的社区讨论。
  • 帮助其他贡献者处理他们的拉取请求和问题,或指导新贡献者。
  • 提交错误报告。查看你可以在 MDN 的 content 代码库中 打开的问题类型。如果你注意到平台错误,你可以在 MDN 的 yari 代码库中 打开问题.
  • 在问题上发表评论,以将对话引导到有益的解决方向。
  • 通过提交 拉取请求 来解决未解决的问题(例如,在 content 代码库中)。
  • 参加社区活动。
  • 帮助宣传 MDN 项目。

要求

要成为贡献者,你必须遵循

特权

贡献者享有以下特权

组织成员

组织成员 是定期参与并为 MDN 网页文档项目做出贡献的既定 贡献者。他们应该以项目的利益行事。

要求

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

  • 打开了两个或更多已合并的拉取请求,解决了两个或更多问题。
  • 为 MDN 网页文档项目贡献至少两个月。
  • 积极为至少一个项目领域做出贡献。

以下两项要求是强制性的

特权

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

维护者

维护者是既定 贡献者,负责 MDN 上的一个或多个项目。他们应该参与项目政策和优先事项的决策。请查看 流程,了解如何提名某人为维护者。

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

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

要求

要具备成为维护者的资格,你必须满足以下一项或多项要求

  • 至少有六个月的 受邀专家 经验。
  • 展现出对项目多个领域的广泛了解。
  • 展现出独立于其他成员影响,为项目利益行使判断的能力。
  • 表现出指导其他贡献者的素质。
  • 同意承诺每月至少投入 16 个小时在项目上工作。
  • 参加每两个月举行一次的社区会议。

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

特权

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

所有者

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

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

要求

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

  • 遵循和执行 MDN 团队规范,包括 社区参与指南Mozilla 政策
  • 遵循 MDN 组织政策并以身作则。
  • 通过 拉取请求流程 建议、记录和实施新策略。
  • 关注和参与整个 MDN 组织中的问题和讨论。
  • 确保在一个星期内,问题或拉取请求能从一个或多个成员那里获得反馈。
  • 对未维护的存储库进行 归档 或删除。
  • 讨论 GitHub 功能,选择要使用的功能,并记录决策。

特权

所有者可以

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

角色概述

角色 要求 特权
贡献者 遵循行为准则和贡献指南 - 贡献者活动邀请
- 有资格成为组织成员
组织成员 - 为 GitHub 帐户启用双因素身份验证
- 启用签名提交

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

特殊角色

一些贡献者角色拥有更细致的责任,并具有特殊资格条件。这些角色包括 聚光灯贡献者受邀专家社区经理

聚光灯贡献者

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

我们每月在 MDN 网站 上推荐一位聚光灯贡献者。请参阅 流程 以推荐聚光灯贡献者。

受邀专家

受邀专家在 MDN 上有贡献记录,参与讨论和评审,或在特定专业领域拥有公认的知识。受邀专家负责 MDN 项目的特定主题领域或组件。他们负责评审和批准其主题或项目领域的拉取请求,解答技术问题,并维护其特定项目的整体健康状况。请参阅 流程 以推荐受邀专家。

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

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

当在受邀专家的主题领域打开拉取请求时,他们会被自动分配为评审者。如果在主题领域有多位专家,则会使用 负载均衡策略 将他们分配给拉取请求。

要求

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

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

特权

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

  • 访问提交和拉取请求审批和合并所需的存储库。
  • 推荐和投票让其他成员成为受邀专家。
  • 参加每周的 MDN Web Docs 编辑通话。

社区经理

社区经理在很多方面扮演着独特的角色。社区经理与 维护者 拥有许多相同的责任。此外,社区经理还肩负以下责任

  • 处理违反我们的 行为准则(即 Mozilla 社区参与指南)的报告,并决定采取适当的行动。
  • 组织和开展社区活动。
  • 组织与社区相关的项目会议。
  • 确定推广 MDN 项目的媒体策略。
  • 定义和实施贡献者入职体验。
  • 为新贡献者和用户提供入职培训。
  • 确保 MDN 项目及其所有参与者的健康和福祉。
  • 识别并协助实施自动化以提高项目的可持续性。
  • 与贡献者和合作伙伴会面并确保健康的合作关系。
  • 在适当的情况下协助进行问题分类和拉取请求评审。
  • 监控所有 沟通渠道
  • 突出表现出色的贡献者,或对 MDN 项目表现出献身精神的贡献者。

流程

推荐维护者

查看谁可以成为 维护者

要推荐某人成为维护者,请在 GitHub 上创建一个问题

  1. mdn/mdn 存储库的 Issues 选项卡中,单击右侧的 新建问题 按钮。
  2. 在“推荐维护者”下,单击开始按钮。
  3. 填写表格,包括您推荐的人的贡献详细信息,然后提交表格。

推荐聚光灯贡献者

查看谁可以成为 聚光灯贡献者

要推荐某人成为聚光灯贡献者,请在 GitHub 上创建一个问题

  1. mdn/mdn 存储库的 Issues 选项卡中,单击右侧的 新建问题 按钮。
  2. 在“推荐聚光灯贡献者”下,单击开始按钮。
  3. 填写表格,包括您推荐的人的贡献详细信息,然后提交表格。

MDN 团队将与推荐的人联系,获取他们的信息,以便在 网站 上的“贡献者聚光灯”栏目下发布。

推荐受邀专家

查看谁可以成为 受邀专家

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

  1. mdn/mdn 存储库的 Issues 选项卡中,单击右侧的 新建问题 按钮。
  2. 在“推荐受邀专家”下,单击开始按钮。
  3. 填写表格,包括您推荐的人的贡献详细信息,然后提交表格。

辞去职位或申请名誉退休

生活中会发生各种事情,您作为贡献者的参与程度可能会随着时间的推移而改变。根据您的情况,您可能希望

  • 暂时休息一下项目。
  • 降级到要求较低的职位。
  • 完全退出项目(申请名誉退休)。

在所有这些情况下,请随时与 MDN 团队 讨论您的情况和当前的参与程度。

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

当责任和要求没有得到满足时,包括反复出现的不活跃模式或违反 行为准则 时,可以降级或移除贡献者。

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

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

我们将不活跃定义为

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

不活跃会损害项目;它可能导致意外延误、贡献者流失以及对项目的信任度降低。贡献者必须积极参与,以树立榜样并展现对项目的承诺。

如果您的时间承诺发生变化,请与社区团队沟通以避免降级或移除;相反,您可以主动选择 暂时辞去职位或转为名誉退休

团队

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

  • 团队中的人员通常会被添加到其感兴趣的相应主题领域(s) 的 CODEOWNERS 文件中。
  • 当拉取请求触及您责任范围内的文件时,根据 CODEOWNERS 文件,您将被自动添加为拉取请求的评审者,使用 GitHub 的 负载均衡算法
  • 团队成员拥有更高级别的存储库访问权限。存储库权限仅分配给成员需要访问的存储库。

MDN GitHub 组织 中的团队包括

  • @Core: 核心 MDN Web Docs 团队
  • @mdn-community-engagement: 负责我们存储库中社区参与的人员
  • @mdn-product: 负责 MDN Plus 产品的人员
  • @localization-team-leads: 领导我们各个本地化团队的人员
  • @OWD: 来自 Open Web Docs 非营利组织的贡献者
  • @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)。