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