メインコンテンツへスキップ
GitHubでこのページを編集

Supersetへの貢献

Supersetは、Apache Software Foundationのプロジェクトです。 Supersetの中核となる貢献者（またはコミッター）は、主に以下のチャンネルでコミュニケーションをとっています（誰でも参加できます）。

その他の参考資料

概要​

以下は、Superset関連のパッケージを含むリポジトリのリストです。

  • apache/supersetは、pypiで配布されているapache-supersetPythonパッケージを含むメインのリポジトリです。このリポジトリには、superset-frontendフォルダの下にあるSupersetのメインTypeScript/JavaScriptバンドルとReactアプリも含まれています。
  • github.com/apache-supersetは、Superset関連の小さなツール、フォーク、Superset関連の実験的なアイデアを管理するGitHub組織です。

貢献の種類​

バグ報告​

バグを報告する最良の方法は、GitHubでIssueを提出することです。以下を含めてください。

  • お使いのオペレーティングシステムの名前とバージョン。
  • Supersetのバージョン。
  • バグを再現するための詳細な手順。
  • トラブルシューティングに役立つ可能性のあるローカル設定に関する詳細。

Pythonスタックトレースを投稿する場合は、Markdownブロックを使用して引用してください。

GitHub Issueとして開かれた機能リクエストは、Discussionsに移動されることに注意してください。

アイデアや機能リクエストの提出​

最良の方法は、GitHubで「アイデア」ディスカッションスレッドを開始することです。

  • どのように機能するかを詳細に説明してください。
  • 実装を容易にするために、スコープをできるだけ狭く保ってください。
  • これはボランティア主導のプロジェクトであり、あなたの貢献は誰の貢献と同じように歓迎されることを忘れないでください:)

大規模な機能やコードベースへの大幅な変更を提案し、それらの変更を推進するのを手伝うには、Superset Improvement Proposal（SIP）を作成してください。 SIP-0のテンプレートを参照してください。

バグ修正​

GitHub issueを確認してください。 #bugタグの付いたissueは、実装したい人が誰でも取り組むことができます。

機能の実装​

GitHub issueを確認してください。 #featureタグの付いたissueは、実装したい人が誰でも取り組むことができます。

ドキュメントの改善​

Supersetは、公式のSupersetドキュメントの一部として、docstring、docs/*.rst、またはブログ記事や記事としてウェブ上にあるかどうかにかかわらず、常に優れたドキュメントを利用できます。詳細については、ドキュメントを参照してください。

翻訳の追加​

英語以外の言語に堪能な場合は、SupersetのUIからテキスト文字列を翻訳するのに役立ちます。 superset/translations/<language_code>/LC_MESSAGES/messages.poにある既存の言語辞書に飛び込んだり、新しい言語用の辞書を作成したりすることもできます。詳細については、翻訳を参照してください。

質問​

StackOverflowに専用のapache-supersetタグがあります。質問するときは、これを使用してください。

貢献者の種類​

Apache Software Foundation（ASF）のプロジェクトガバナンスモデルに従い、Apache Supersetには特定の貢献者役割のセットがあります

PMCメンバー​

プロジェクト管理委員会（PMC）メンバーは、プロジェクトの管理を支援するためにPMCによって選出された人です。PMCメンバーは、コミュニティ開発、リリース管理、プロジェクトガバナンスなど、プロジェクト全体の健全性に責任を負います。PMCメンバーは、プロジェクトの技術的な方向性にも責任を負います。

ApacheプロジェクトPMCの詳細については、https://apache.dokyumento.jp/foundation/governance/pmcs.htmlを参照してください。

コミッター​

コミッターとは、コードリポジトリへの書き込みアクセス権（コミットアクセス権）を持つためにPMCによって選出された人です。彼らは、コード、ドキュメント、ウェブサイトを変更し、他の人からの貢献を受け入れることができます。

コミッターとPMCメンバーの公式リストはこちらにあります。

貢献者​

貢献者とは、コード、テスト、ドキュメント、issue、ディスカッションなど、あらゆる方法でプロジェクトに貢献した人です。

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 Software Foundationと署名されたICLAを所持している。
  • セキュリティチームメンバーによって特別に許可されない限り、保留中および未解決のセキュリティ問題に関する情報を誰にも（雇用主を含む）公開しないこと。たとえば、セキュリティチームが問題の診断と解決に外部の専門家の関与が必要であることに同意した場合などです。

Apache Supersetの特定のバージョンのリリースを監督する貢献者であるリリースマネージャーは、デフォルトでセキュリティチームのメンバーです。ただし、彼らはセキュリティ問題の評価、議論、修正に積極的に参加することは期待されていません。

セキュリティチームのメンバーは、以下の一般的な期待にも従う必要があります。

  • Supersetでのセキュリティ問題の評価、議論、修正、リリースに積極的に参加する。
  • 公開フォーラムでセキュリティ修正について議論することを避ける。プルリクエスト（PR）の説明には、セキュリティ問題に関する情報は含めないでください。対応するJIRAチケットには、PRへのリンクを含める必要があります。
  • 修正に貢献したセキュリティチームのメンバーは、CVEレポートに、所属先（含めることを選択した場合）とともに、修復開発者としてリストされる場合があります。