MDN 网页文档角色和团队
MDN 网页文档项目的成功和发展很大程度上归功于我们的贡献者社区。一些贡献者投入了一部分时间来帮助完成运行 MDN 网页文档的日常任务。网站的更改,包括维护任务,由员工、承包商和致力于 MDN 网页文档的健康、发展和维护的合作伙伴网络执行。该项目在很大程度上依赖于 角色 和 团队 在 GitHub 上的 MDN 组织 中来管理和整合来自这些不同群体的更改。组织成员列表可以 在这里找到.
社区贡献对这个开源项目帮助很大。贡献者可以使用他们在 MDN 网页文档上的工作来展示他们的写作、技术和协作技能,以及与来自不同背景的人合作的能力。本节介绍你在志愿参与 MDN 网页文档项目时可以承担的角色。
角色
贡献者
贡献者,或社区参与者,用他们的时间、技能、意见和想法来为项目添砖加瓦。贡献者直接参与项目并为其增值。除了编写和测试代码之外,贡献还包括创建和更新文档、研究、修复错误以及帮助其他社区成员。
根据你贡献的频率,你可以是一名偶尔贡献者或一名活跃贡献者。如果你对项目产生了重大影响,你可能会被提名为 亮点贡献者 或被提升为 组织成员.
如果你刚接触这里,并且想要成为贡献者,请查看我们的 贡献指南 和 MDN GitHub 组织中的代码库.
作为贡献者,你可以通过以下活动参与项目
- 参与 沟通渠道 上的社区讨论。
- 帮助其他贡献者处理他们的拉取请求和问题,或指导新贡献者。
- 提交错误报告。查看你可以在 MDN 的
content
代码库中 打开的问题类型。如果你注意到平台错误,你可以在 MDN 的yari
代码库中 打开问题. - 在问题上发表评论,以将对话引导到有益的解决方向。
- 通过提交 拉取请求 来解决未解决的问题(例如,在
content
代码库中)。 - 参加社区活动。
- 帮助宣传 MDN 项目。
要求
要成为贡献者,你必须遵循
- Mozilla 行为准则
- 贡献指南(查看每个代码库中的
CONTRIBUTING.md
文件;例如,这些是mdn/content
代码库的贡献指南)。
特权
贡献者享有以下特权
- 贡献者活动邀请。
- 有资格成为 组织成员。
组织成员
维护者
维护者是既定 贡献者,负责 MDN 上的一个或多个项目。他们应该参与项目政策和优先事项的决策。请查看 流程,了解如何提名某人为维护者。
作为维护者,你参与以下活动
- 确定你负责项目的优先事项。
- 参加社区会议。
- 指导所有其他角色中的新老贡献者。
- 根据技能集,在你负责的项目领域中提出、批准或实施
- 代码和基础设施改进
- 内容改进
- 流程改进
要求
要具备成为维护者的资格,你必须满足以下一项或多项要求
- 至少有六个月的 受邀专家 经验。
- 展现出对项目多个领域的广泛了解。
- 展现出独立于其他成员影响,为项目利益行使判断的能力。
- 表现出指导其他贡献者的素质。
- 同意承诺每月至少投入 16 个小时在项目上工作。
- 参加每两个月举行一次的社区会议。
注意:如果你认为某人有资格担任此角色,你可以 提名维护者.
特权
维护者有权批准和合并拉取请求。
所有者
所有者拥有广泛的权限来管理用户和 GitHub 团队,维护 MDN 组织 中所有代码库的访问权限,维护代码库设置,以及部署到生产环境。所有者受所有其他贡献者角色的要求约束。
注意:所有者角色目前仅限于 Mozilla 员工。
要求
除了其他贡献者角色的责任外,所有者还承担以下责任
- 遵循和执行 MDN 团队规范,包括 社区参与指南 和 Mozilla 政策。
- 遵循 MDN 组织政策并以身作则。
- 通过 拉取请求流程 建议、记录和实施新策略。
- 关注和参与整个 MDN 组织中的问题和讨论。
- 确保在一个星期内,问题或拉取请求能从一个或多个成员那里获得反馈。
- 对未维护的存储库进行 归档 或删除。
- 讨论 GitHub 功能,选择要使用的功能,并记录决策。
特权
所有者可以
- 根据需要添加和删除组织所有者和成员。
- 根据需要添加和删除特定存储库的协作者。
- 根据需要添加存储库(作为新项目或迁移)。
角色概述
特殊角色
聚光灯贡献者
受邀专家
受邀专家在 MDN 上有贡献记录,参与讨论和评审,或在特定专业领域拥有公认的知识。受邀专家负责 MDN 项目的特定主题领域或组件。他们负责评审和批准其主题或项目领域的拉取请求,解答技术问题,并维护其特定项目的整体健康状况。请参阅 流程 以推荐受邀专家。
除了 组织成员 的职责外,受邀专家还负责
- 遵循 评审指南。
- 评审其主题领域的拉取请求。
- 帮助其他贡献者成为评审者。
当在受邀专家的主题领域打开拉取请求时,他们会被自动分配为评审者。如果在主题领域有多位专家,则会使用 负载均衡策略 将他们分配给拉取请求。
要求
要符合受邀专家的资格,您必须满足以下一项或多项要求
- 证明对特定主题领域有深入的了解。
- 承诺对其分配的主题领域负责。
- 支持新贡献者和偶尔的贡献者,并帮助他们准备好拉取请求以合并。
- 参加每两个月举行一次的社区会议。
特权
受邀专家会被添加到 受邀专家团队 和相应的主题或项目团队。受邀专家可以
- 访问提交和拉取请求审批和合并所需的存储库。
- 推荐和投票让其他成员成为受邀专家。
- 参加每周的 MDN Web Docs 编辑通话。
社区经理
社区经理在很多方面扮演着独特的角色。社区经理与 维护者 拥有许多相同的责任。此外,社区经理还肩负以下责任
- 处理违反我们的 行为准则(即 Mozilla 社区参与指南)的报告,并决定采取适当的行动。
- 组织和开展社区活动。
- 组织与社区相关的项目会议。
- 确定推广 MDN 项目的媒体策略。
- 定义和实施贡献者入职体验。
- 为新贡献者和用户提供入职培训。
- 确保 MDN 项目及其所有参与者的健康和福祉。
- 识别并协助实施自动化以提高项目的可持续性。
- 与贡献者和合作伙伴会面并确保健康的合作关系。
- 在适当的情况下协助进行问题分类和拉取请求评审。
- 监控所有 沟通渠道。
- 突出表现出色的贡献者,或对 MDN 项目表现出献身精神的贡献者。
流程
推荐维护者
推荐聚光灯贡献者
推荐受邀专家
辞去职位或申请名誉退休
生活中会发生各种事情,您作为贡献者的参与程度可能会随着时间的推移而改变。根据您的情况,您可能希望
- 暂时休息一下项目。
- 降级到要求较低的职位。
- 完全退出项目(申请名誉退休)。
在所有这些情况下,请随时与 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
。
- 每个主题领域都有一个子团队——无障碍、附加组件、CSS、HTML、HTTP、JavaScript、SVG、Web API 和 WebAssembly。例如,有
要成为团队成员,您必须
联系 MDN 团队
如有任何疑问或反馈,请联系 mdn-web-docs-community (at) mozilla (.com)。