superset-contribute

Superset への貢献

「Superset で X を修正／構築したい」というユーザーの意向を、リポジトリのルールに従ったマージ可能な PR につなげます。チェックアウトしたリポジトリに CONTRIBUTING.md／DEVELOPMENT.md／AGENTS.md がある場合は、それらが正式な指針です。内容を確認し、この概要よりも優先してください。

1. まず変更の範囲を決める

• バグ修正、ドキュメント、小規模な改善 → そのまま PR を作成します。Issue は不要です
• 新機能や大規模な変更 → 実装に着手する前に https://github.com/superset-sh/superset/issues/new/choose で Issue を作成し、方針について合意します
• 質問 → Issue ではなく Superset の Discord で尋ねてください

2. セットアップする

1. gh auth status を実行し、フォークしてクローンします：gh repo fork superset-sh/superset --clone（または、既存のクローンにフォークのリモートを追加します）
2. 最適な開発環境として、クローンを Superset アプリのプロジェクトに追加し、変更ごとにワークスペースを作成します。コントリビューションは管理対象のワークツリー内で開発します
3. 新しいワークスペース／ワークツリーで ./.superset/setup.local.sh を一度実行します（ワークスペースごとのポート、アプリの識別情報、ローカルサービス、シード済みの開発アカウントを設定します。外部の認証情報は不要です）。その後、bun run dev を実行します
4. Bun のみを使用してください。npm／yarn／pnpm は使用しないでください。ルートの AGENTS.md を読み、その指示に従います。

3. マージ可能な状態にする

• main からブランチを作成します。1 つの PR につき 1 つの変更とし、無関係な修正は 2 つ目の PR に分けてください
• プッシュする前に bun run lint:fix を実行し、続いて bun run lint がクリーンに終了すること（CI は警告でも失敗します）、bun run typecheck、bun run test を確認します
• PR のタイトルは Conventional Commits 形式にします（feat(desktop): ...、fix(web): ...）。PR はタイトルをコミットメッセージとしてスカッシュマージされます
• 動作することを示す証拠を含めます。ユーザーに見える変更にはスクリーンショットまたは録画を、修正には変更前／変更後を添えてください。開発用デスクトップアプリでは、きれいにキャプチャするための CDP を利用できます。CONTRIBUTING.md の「Capturing screenshots via CDP」を参照してください
• 「Allow edits from maintainers」にチェックを入れ、重要な変更では Issue へのリンクを追加します

4. PR を作成する

superset-sh/superset の main に対して gh pr create を実行し、PR テンプレートに正確に記入します（実行した内容、クリックした箇所、テストでカバーした内容）。その後、PR の URL をユーザーに伝えます