跳至主要内容
在 GitHub 上编辑此页面

为 Superset 贡献

Superset 是一个Apache 软件基金会 项目。Superset 的核心贡献者（或提交者）主要在以下渠道进行交流（任何人都可以加入）：

更多参考

入门​

以下是一些包含 Superset 相关软件包的仓库列表。

  • apache/superset 是包含 apache-superset Python 包的主要仓库，该包在 pypi 上发布。此仓库还在 superset-frontend 文件夹下包含 Superset 的主要 TypeScript/JavaScript 包和 React 应用程序。
  • github.com/apache-superset 是我们用来管理 Superset 相关的小型工具、分支和 Superset 相关实验性想法的 GitHub 组织。

贡献类型​

报告错误​

报告错误的最佳方式是在 GitHub 上提交一个问题。请包含以下内容：

  • 您的操作系统名称和版本。
  • Superset 版本。
  • 重现错误的详细步骤。
  • 有关您本地设置的任何可能有助于故障排除的详细信息。

在发布 Python 堆栈跟踪时，请使用Markdown 代码块进行引用。

请注意，作为 GitHub 问题打开的功能请求将被移至讨论区。

提交想法或功能请求​

最佳方式是在 GitHub 上启动一个“想法”讨论主题

  • 详细解释它的工作原理。
  • 尽可能缩小范围，以方便实现。
  • 请记住，这是一个志愿者驱动的项目，您的贡献与任何人的贡献一样受欢迎：）

要提出大型功能或对代码库进行重大更改，并帮助推动这些更改，请创建一个**Superset 改进提案 (SIP)**。请参阅来自SIP-0 的模板。

修复错误​

查看 GitHub 问题。标记为 #bug 的问题对任何想要实施它们的人开放。

实施功能​

查看 GitHub 问题。标记为 #feature 的问题对任何想要实施它们的人开放。

改进文档​

Superset 始终可以使用更好的文档，无论是作为官方 Superset 文档的一部分，还是在文档字符串中、docs/*.rst 中，甚至在网络上作为博客文章或文章。请参阅文档 了解详细信息。

添加翻译​

如果您精通非英语语言，您可以帮助翻译 Superset UI 中的文本字符串。您可以跳入现有的语言字典，位于 superset/translations/<language_code>/LC_MESSAGES/messages.po，甚至可以为新的语言创建字典。请参阅翻译 了解详细信息。

提问​

有一个专门的apache-superset 标签 在StackOverflow 上。提问时请使用它。

贡献者类型​

遵循 Apache 软件基金会 (ASF) 的项目治理模型，Apache Superset 有一套特定的贡献者角色。

PMC 成员​

项目管理委员会 (PMC) 成员是指由 PMC 选举出来帮助管理项目的人员。PMC 成员负责项目的整体健康状况，包括社区发展、版本管理和项目治理。PMC 成员还负责项目的技术方向。

有关 Apache 项目 PMC 的更多信息，请参阅https://apache.org/foundation/governance/pmcs.html

提交者​

提交者是指由 PMC 选举出来对代码仓库具有写入权限（提交权限）的人员。他们可以修改代码、文档和网站，并接受他人的贡献。

可以在此处 找到提交者和 PMC 成员的官方列表。

贡献者​

贡献者是指以任何方式为项目做出贡献的人员，包括但不限于代码、测试、文档、问题和讨论。

您还可以查看 Superset 项目的 PMC 成员晋升指南，网址为：https://github.com/apache/superset/wiki/Guidelines-for-promoting-Superset-Committers-to-the-Superset-PMC

安全团队​

安全团队是 PMC 成员、提交者和非提交者的选定子集，负责处理安全问题。

新的安全团队成员由 PMC 成员通过投票选出。您可以通过向private@superset.apache.org 发送邮件请求加入团队。但是，团队应该规模较小，重点是解决安全问题，因此将根据具体情况评估请求，并且团队规模将保持相对较小，仅限于积极关注安全的贡献者。

该安全团队必须遵循ASF 漏洞处理流程。

每个新的安全问题都会在ASF 的 JIRA Superset 安全项目 中跟踪为 JIRA 票证。

安全团队成员必须：

  • 已与 Apache 软件基金会签署ICLA。
  • 除非安全团队成员明确授权，例如如果安全团队同意诊断和解决问题需要外部专家的参与，否则不要向任何人（包括其雇主）透露有关待处理和未修复的安全问题的信息。

发布经理，即负责发布特定版本的 Apache Superset 的贡献者，默认情况下是安全团队的成员。但是，他们不应积极参与评估、讨论和修复安全问题。

安全团队成员还应遵循以下一般预期：

  • 积极参与评估、讨论、修复和发布 Superset 中的安全问题。
  • 避免在公开论坛中讨论安全修复。拉取请求 (PR) 描述不应包含任何有关安全问题的信息。相应的 JIRA 票证应包含指向 PR 的链接。
  • 为修复做出贡献的安全团队成员可能会在 CVE 报告中列为修复开发人员，以及他们的工作隶属关系（如果他们选择包含）。