Submitting Pull Requests

pgAdminの機能またはバグ修正を開発する前に、常にメーリングリストpgadmin-hackers@postgresql.orgの開発者に連絡して、計画について話し合う必要があります。これにより、他の人があなたが何をしているのかを知り、作業の重複を避けることができます。大規模な変更の場合、コミュニティは、後で却下される可能性のあるコードを書くことにあまりにも多くの時間を費やす前に、アイデアを議論して洗練する機会を与えます。

リリースのtarballではなく、GITソースコードリポジトリからのソースコードのチェックアウトに対して常に変更を開発する必要があります。これにより、ブランチで最新のコードで作業していることが保証され、プルリクエストを正しく生成しやすくなります。

2022年9月現在、pgAdminソースリポジトリはhttps://github.com/pgadmin-org/pgadmin4にあります。比較的単純な変更の一般的なワークフローは次のとおりです。

  1. GitHubのpgAdmin4プロジェクトにアクセスし、 Fork ボタンをクリックして、GitHubアカウントに独自の開発リポジトリを作成します。

  2. 次のようなコマンドを使用して、ソースコードのローカルコピーをチェックアウトします。

$ git clone https://github.com/<your GitHub username>/pgadmin4.git

  1. ローカル開発環境で変更を開発およびテストします。

  2. 変更を確認し、徹底的にチェックして、それらがpgAdmin Coding Standards を満たすことを確認し、 Coding Standards に対してそれらを確認して、拒否される可能性を最小限に抑えます。

  3. 変更に満足したら、適切なメッセージでコミットします。先頭に1行の要約を含め、必要に応じて、要約の後の空白行に続いて段落を追加します。

  4. 変更をリポジトリのフォークにプッシュします。

  5. GitHubに戻り、 pgadmin-org/pgadmin4 master ブランチに対して新しいプルリクエストを作成します。

    注釈

    各プルリクエストには、単一のバグ修正または機能を単一のコミットとして含める必要があります。必要に応じて、送信する前に、大規模な変更または機能の複数のコミットを1つのコミットにスカッシュする必要があります。

  6. あなたのプルリクエストは、開発チームの1人以上のメンバーによってレビューされ、受け入れられるか、要求された変更とともに返送されます。場合によっては、変更が適切と見なされない場合、拒否される場合があります。これが、重要な時間を費やす前にチームと自分の仕事について話し合うことが重要である理由です。

より複雑な変更については、pgAdminリポジトリのフォークで フィーチャーブランチ を使用し、それを使用してプルリクエストを作成することをお勧めします。

注釈

これは、ワークフローの簡単な例です。代わりに GitHub CLI などの他のツールを使用することを選択できます。ただし、そのようなツールとワークフローを文書化することは、pgAdminドキュメントの範囲外です。