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 ブランチに対して新しいプルリクエストを作成します。

    注釈

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

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

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

注釈

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