为 Apache Beam 做贡献

Apache Beam 是一个开源项目，由友好的用户、贡献者、贡献者和项目管理委员会 (PMC) 成员开发和维护。

每个人都欢迎加入并以多种方式为项目做出贡献，不仅仅是代码贡献。诸如提出问题、报告错误、提出新功能、改进文档、添加到网站、组织活动或撰写博客文章等贡献，都是受欢迎的，并且会得到认可。

这对您有什么好处？

您可以贡献的方式

以下是您可以开始贡献的一些方法

贡献如何做
参与并分享想法
提交错误
  1. 创建一个 GitHub 问题 并将其标记为错误

    2. 或者

  2. 发送电子邮件至 [email protected]，主题： [Bug] <bug 摘要>，并尽可能详细地描述问题。
提出功能
  1. 创建一个 GitHub 问题 并将其标记为功能请求

    2. 或者

  2. 发送电子邮件至 [email protected]，主题： [Feature Proposal] <您的想法>。
修复已知问题
  • 在您要处理的 问题 上评论 "。take-issue"。这会导致问题分配给您。
  • 如果合适，进行更改并打开一个 拉取请求。
  • 一旦所有工作完成，评论 "。close-issue" 来关闭问题。
  • 您可以使用 "好的第一个问题" 标签 找到好的第一个问题。
  • 您也可以在 维基 上找到更多开发人员文档。
改进文档点击我们文档中的编辑图标，它将带您到我们的 GitHub，在那里您可以自动进行所需的更改并发送拉取请求。
改进网站
  • 按照网站 贡献指南 自己进行更改。
  • 查看我们在 GitHub 上的 网站积压 以找到改进的空间，或提出改进建议。
撰写博客文章讲述您自定义用例的故事，或分享您的建议和最佳实践。
分享您的成功案例访问我们的 案例研究 页面并分享您的故事或添加您公司的徽标。
制作社交媒体发布分享 Beam 帮助赋能的用例或您实现的数据处理性能。宣传即将到来的 Beam 峰会和会议。
组织活动发送电子邮件至 [email protected] 分享您要组织的 Beam 活动的想法。
构建新功能，例如新的 I/O 连接器或 PTransform
  • 创建并贡献一个自定义的 I/O 连接器 用于您要连接到的特定数据存储系统，如果它还没有在 I/O 列表 中。
  • 查看我们的项目积压以获得一些构建灵感。
  • 遵循我们的 代码贡献指南。
分享代码示例或模板
测试发布候选版本任何人都可以通过 [email protected] 邮件列表 提出发布。在您的项目中尝试 Apache Beam 发布，投票支持发布候选版本，通过 [email protected] 通知社区结果和发现的任何问题。了解有关如何验证 Beam 发布的更多信息 此处。
还有其他想法吗？如果您想以其他方式做出贡献，并且不确定如何开始，请向 [email protected] 发送提案。

成为贡献者

如果您喜欢为 Apache Beam 做贡献，您积极参与 Apache Beam 邮件列表、Slack 频道或参加/组织活动，那么您有资格成为项目贡献者。

贡献者是社区成员，他们对项目的存储库有写入权限（即，他们可以自己修改代码、文档和网站，还可以帮助进行代码审查并接受其他贡献）。

虽然没有严格的协议来成为贡献者，但我们最看重的是您展现出 Apache Beam 贡献者的特征，并且一直为项目和社区做出贡献。

新的贡献者候选人由当前的贡献者或 PMC 成员推荐，并由 PMC 团队投票决定。因此，如果您想成为贡献者，请积极参与社区并继续为 Apache Beam 做贡献。您可能还想与其他贡献者交谈，并征求他们的建议和指导。随时直接向任何贡献者发送电子邮件，征求他们的意见！

Apache Beam 贡献者的特征

了解、维护和强化 Beam 社区的实践。 了解更多。
了解、维护和强化 Apache 软件基金会行为准则。 了解更多。
了解、维护和强化 Apache 软件基金会贡献者的职责。 了解更多。

成为项目管理委员会 (PMC) 成员

PMC 是根据 Apache 软件基金会治理模型 “Apache Way” 的项目官方管理机构。PMC 成员投票决定 Apache Beam 的社区和技术方向，并直接负责监督发布以及社区的健康发展。

PMC 成员还负责确保他们的项目符合 ASF 董事会或其他公司官员制定的某些核心要求，例如遵循法律、品牌和基础设施相关要求，以及确保他们的社区在 ASF 行为准则 内运作。

由于 PMC 成员负责制定 Apache Beam 的愿景，并领导我们的社区协同工作以实现该愿景，因此我们寻找能够履行 PMC 职责，以及领导我们的社区实现其愿景的尽职尽责的个人。这就是为什么我们努力构建一个多元化的 PMC，以补充技能和专业知识，分享相同的价值观。

理想情况下，我们在活跃的社区成员中寻找候选人，他们已经展现出塑造 Beam 方向的主动性，并展现出学习官方流程的意愿，例如如何创建或验证发布，如何确保活动商标合规性等。我们还期望 PMC 候选人头脑清醒、建设性、支持性，并且愿意在必要时 “不同意但服从”。

PMC 成员也是贡献者，因此如果他们还没有加入，他们将在加入 PMC 时自动成为贡献者。因此，Apache Beam 贡献者的特征也适用于 PMC 成员。

听取社区的声音

知识共享和协作是社区中自然而然的事情。我们共同可以解决最复杂的问题并找到解决方案。

Matt Casters
联合创始人
Apache Hop

“我真的很喜欢使用 Beam。对它内部机制的理解让您可以微调开源软件并对其进行定制。Beam 非常强大，抽象是它最重要的功能。

Talat Ulyarer
高级主管
软件工程师
Palo Alto Networks

我的收获是：每个人都应该加入 [Apache Beam] 邮件列表！这是所有讨论发生的地方，也是学习的好地方。我还鼓励每个人参加会议并积极参与会议，以结识并与社区建立联系。

Tobias Kaymak
高级数据工程师
Ricardo