立即迁移到 Netlify

Netlify 宣布 Gatsby Cloud 的下一次迭代。 了解更多

支持登录

Gatsby 的治理模式

简介

Gatsby 是一个 开源 项目，由 Gatsby, Inc. 的员工和一个活跃的贡献者社区支持。

本文档的目的是提供有关 Gatsby 开源软件 (OSS) 的管理和维护的最新信息，并展示 Gatsby 的领导层与社区之间的各种资源和沟通渠道。它还包括对贡献者级别、接受的贡献类型、投票流程和审核的详细描述。此外，它还概述了您如何参与 Gatsby OSS。建立此治理模型将有助于支持 Gatsby 社区内部以及社区与公司之间积极而富有成效的沟通/协作。

所有社区成员都必须遵守 行为准则 (CoC)。 CoC 违规的后果在 审核 部分有详细说明。

参与进来

欢迎所有形式的贡献，包括提交 issue、贡献代码、编写新文档以及更新和调整、撰写博文、帮助他人等等。阅读 贡献指南，了解社区能为您做什么以及您可以为社区做什么。

Gatsby 用户集体

Gatsby 用户集体 的目标是实现社区插件维护的民主化，让更多人能够协助插件的维护，并在 Gatsby 生态系统中创建更高质量的插件。为 Gatsby 用户集体做出贡献是一项有价值的贡献！

贡献领域

由于 Gatsby 的核心是一套复杂的软件，在能够高效贡献之前需要一些入门指导。我们在此明确界定了目前哪些领域在无需与团队事先沟通的情况下即可接受贡献，哪些不行。这对于新功能尤其重要，因为新功能总是需要维护成本——而在不完全了解 Gatsby 的上下文的情况下进行更改是困难的。此列表并非一成不变，可能会发生变化，例如当引入“核心维护者 (L3)”角色时。

我们接受所有类型的贡献到

我们接受所有类型的贡献到 packages，但以下包有额外要求

对于这两个包，我们要求您在提交 PR 之前先打开一个 功能请求（对于较大的更改，请打开 RFC）。提交 bug 修复和文档更新等贡献，无需事先与团队沟通，也不需要功能请求/RFC。

贡献者级别

我们将不同程度的贡献视为级别，大多数级别都可以通过，而无需具备编码技能或多年经验。我们对贡献者最看重的两点是

  • 积极参与 - 每个人的时间都很有价值，您在这里为 Gatsby 做出贡献真是太棒了！感谢您参与我们的旅程。

  • 成为我们社区的积极成员 - 超越行为准则，致力于在 PR、issue 讨论、Discord 对话以及社区之外的互动中进行健康的沟通。

每个级别都将在 Discord 和 GitHub 上解锁新的特权和职责。以下是每个贡献者级别的摘要。

级别 1 (L1) - 贡献者

您是否为 Gatsby 的健康、成功或增长做出了（无论大小）贡献？恭喜您，您已正式被认可为项目的贡献者！

认可的贡献

  • GitHub: 提交已合并的 PR
  • GitHub: 提交详细的功能请求或 RFC
  • GitHub: 更新文档
  • 在 GitHub、Discord 等平台帮助他人
  • 在 Stack Overflow、Twitter 等平台回答问题
  • 撰写关于 Gatsby 的博客、视频、播客和直播
  • 此列表不完整！类似的贡献也将被认可。

特权

目前此角色没有特定的特权，除了您可以声称 免费 Gatsby 纪念品。如果您有想法，请告诉我们！

职责

此角色不要求任何额外的职责或时间承诺。我们希望您能继续留下并参与进来！

如果您有兴趣达到下一个级别并成为维护者，您可以在下一节开始探索其中的一些职责。

提名流程

不适用 (n/a)

级别 2 (L2) - 维护者

维护者角色适用于任何希望加入团队并参与 Gatsby 长期维护的贡献者。

维护者角色对 Gatsby 的长期健康至关重要。维护者支持 团队成员，共同作为新 issue、PR 和 Discord 活动的第一道防线。用户最有可能首先在 Discord 或 GitHub 上与维护者互动。

维护者不一定需要编写代码！一些维护者大部分时间都在 Discord 中度过，维护健康的社区。维护者也可以被认为是 Discord 上的 审核员，并拥有特殊的审核权限。

认可的贡献

达到此级别没有严格的最低贡献数量要求，只要您能表现出在一段时间内（至少几周）的持续参与。

  • GitHub: 提交非琐碎的 PR 和 RFC
  • GitHub: 审查非琐碎的 PR 和 RFC
  • Discord: 在 Discord 中支持用户，尤其是在“帮助”类别中
  • Discord: 积极参与 RFC 通话和其他活动
  • GitHub + Discord: 对用户 issue 进行分类和确认
  • 此列表不完整！类似的贡献也将被认可。

特权

  • 拥有 贡献者角色 的所有特权，外加…
  • 在 Discord 上获得 @Maintainer 角色的邀请
  • 在 GitHub 上获得 Maintainers 团队的邀请。
  • Discord 上的新名称颜色：蓝色。
  • 受邀加入 Discord 上的私人 #maintainers 频道。
  • 能够审核 Discord，以删除垃圾信息、有害言论等。
  • 能够加入 Discord 上的 @Moderator 角色（可选，选择加入）。
  • 能够审查 GitHub PR。
  • 能够投票表决 某些 提案（参见下文 投票）。

职责

  • 作为团队的一员参与项目。
  • 为 Gatsby 社区带来友好、热情的氛围。
  • 活跃于 Discord，尤其是在“帮助”类别中。
  • 对新 issue 进行分类。
  • 审查 PR。
  • 合并部分非琐碎的社区 PR。
  • 合并您自己的 PR（经过审查和批准后）。

提名

要被提名，被提名人需要在至少几周的时间里已经实际承担了维护者的一些职责。您可以通过在 Discord 上联系一名 @Team 成员来申请，该成员将触发 投票流程。

在极少数情况下，此角色可能会被 管理员 (Admin) 撤销。但是，在正常情况下，此角色将一直授予，直到贡献者希望继续参与项目为止。

其他角色

团队 (Team)

团队 (Team) 是 Gatsby, Inc. 员工的特殊称谓，独立于我们的治理模型。团队角色的设计目的是帮助我们这些全职从事 Gatsby 工作的人高效工作，同时又不会“走捷径”而绕过我们的治理模型。

特权

  • 拥有 维护者角色 的所有特权，外加…
  • 在 Discord 上获得 @Team 角色的邀请
  • Discord 上的新名称颜色：紫色。
  • GitHub 上的 Team。
  • 能够合并所有 GitHub PR。
  • 能够投票表决所有提案（参见下文 投票）。
  • 对所有 npm 包的发布权限。

职责

  • L2 的所有职责，包括…
  • 项目的所有权。
  • 维护和改进整体架构。
  • 跟踪并确保开放 PR 的进展。
  • 审查和合并更大、更复杂的 PR。
  • 定义项目方向和规划。
  • 能够决定审核决定。

提名

不适用 (n/a)

离开团队

当某人离开 Gatsby, Inc. 时，他们将失去团队特权，并恢复到其在治理结构中的原始成员级别（无论他们加入团队前是哪个级别）。

如果该人员希望在离开后继续在 Gatsby 工作，他们可以申请提名，成为正式的 L2 贡献者。此提名将遵循该角色的正常投票规则和程序（参见下文 投票）。

管理员 (Admin)

管理员 (Admin) 是 团队 内的一个附加特权，主要是一个行政性质的特权。

特权

  • 拥有 团队 的所有特权，外加…
  • 在 Discord 上获得 @Admin 角色的邀请
  • GitHub 上的管理权限。
  • Discord 上的管理权限（可选）。

职责

  • 团队的所有职责

提名

不适用 (n/a)

决策流程

关于 Gatsby 开源软件的决策最终由 Gatsby, Inc. 的领导层和团队做出。我们相信，围绕开源软件建立的创始公司有责任建立强大的业务来维持这些开源工具和依赖它们的社区，而这有时会要求我们将某些高需求的工具和功能保留给 Gatsby 的商业产品。话虽如此，我们非常认真地对待我们对社区的责任，并在确定产品路线图时仔细考虑社区的需求和关切。

如果您想了解我们如何处理商业和开源工作之间的关系，请参阅这篇博文：创始组织：创建一个可持续支持我们开源社区的公司。

功能请求

请在 GitHub Discussions 上提交一个功能请求来表达您的想法。对于较大的更改，请考虑提交 RFC。团队 将审查收到的请求并给出初步评估。

RFC (征求意见稿)

有关更多详细信息，请参阅专门的 RFC 流程文档。

投票

某些项目决策（如成员提名）需要投票。以下是需要投票的更改以及约束该投票的规则。

任何一位 管理员 都可以发起对任何未列出的项目决策的投票。然后，该管理员将成为本次投票的负责人，并处理所有必要的行动。通用规则将适用，以及管理员自行决定的任何附加规则。如果此未列出的项目决策预计将来会重复，则应商定投票规则，然后将其添加到本文档中。

通用投票规则

  • 成员可以弃权任何投票。
  • 在 3 天内未投票的成员将自动弃权。
  • 管理员可以缩短 3 天自动弃权的时间，以处理紧急决策。
  • 管理员保留以公开披露理由否决批准的权利。

投票：维护者 (L2) 提名

此流程在进行有效提名后启动。

谁可以投票：所有维护者（L2 及以上）。

  1. 应在 Discord #maintainers 频道（所有维护者的私人频道）中创建一个投票帖子。
  2. 任何维护者、团队成员或管理员都可以创建投票帖子。
  3. 一旦创建了投票帖子，现有的维护者就可以在私下讨论提名。
  4. 正常的 3 天投票和讨论窗口从帖子创建开始。
  5. 投票可以在帖子中进行（对其他投票者可见），也可以通过私信给负责人管理员进行。
  6. 投票完成后，帖子将被删除。
  7. 投票必须获得绝大多数（70%以上）才能通过。
  8. 如果投票通过：被提名者将成为维护者，并获得所有相应的特权。
  9. 如果投票失败：负责人管理员负责告知被提名者建设性的、可操作的反馈。（注意：如果被提名人以其他方式未被告知其提名，则无需此步骤）。

审核

下面概述了行为准则违规审查流程。

举报

任何人都可以举报违规行为。违规行为可以通过以下方式举报：

  • 私下通过电子邮件发送至 conduct@gatsbyjs.com。
  • 私下通过 Discord 上的团队成员发送直接消息。
  • 公开通过 GitHub 评论（提及 @gatsbyjs/team）。
  • 公开通过项目 Discord 服务器。

谁会参与？

每次举报都会指定审查员。最初将是所有团队成员。

如有任何利益冲突——即团队成员与某情况有个人关联——必须立即回避。

应报告人要求，并经审查员认为适当时，可由另一名中立第三方参与审查和决策过程。

审查

如果报告信息不足，审查员将努力在采取行动前获取所有相关数据。

审查员随后将审查事件，并尽最大努力确定

  • 发生了什么。
  • 该事件是否构成违反行为准则。
  • 谁（如果有）参与了违规行为。
  • 这是否是一个持续发生的情况。

审查员应争取迅速达成解决方案；如果一周内未达成一致，他们将告知相关方计划日期。

解决方案

审查员将根据收集到的信息和潜在后果来确定对策。这可能包括

  • 不采取进一步行动
  • 发出训诫（私下或公开）
  • 要求道歉（私下或公开）
  • 永久禁止加入 GitHub 组织和 Discord 服务器
  • 撤销贡献者身份

灵感来自 Astro 和 Blitz。

立即开始构建，在 Netlify!
在 GitHub 上编辑此页面
©2025Gatsby, Inc.
无障碍声明品牌指南
使用条款隐私政策