コード ビューにプル リクエストを使用する

ファイルを追加したり既存のコードを更新したりしたら、そのコードを Bitbucket Cloud のリポジトリにマージできます。ただし、マージを行う前に、そのコードの品質や、既存の機能に影響しないことを確認する必要があります。コードの更新や改善のフィードバックを受け取るために、追加されたすべてのコード行を含むプル リクエストを作成できます。プル リクエストにより、同僚へのコード レビューの依頼と、対象のユーザーの直近のコミットに基づくビルド ステータスの確認を行うことができます。

プル リクエストを使用するには、メインのコード ベースとは別のブランチ (行) でコードを開発できるよう、ブランチまたはフォークを使用する必要があります。 

「Git のフィーチャー ブランチ ワークフロー」ヘルプ ドキュメントで、大規模なワークフロー例でプル リクエストを活用する方法を確認できます。

プル リクエスト プロセス

プル リクエストの本質は、コード レビューとコラボレーションです。プル リクエストが複数ある場合、ユーザーはロールに応じて、作成者、レビュアー、またはその両方の作業を行う場合があります。以下は、エンドツーエンド プル リクエスト プロセスの流れを説明しています。

プル リクエストの作成者

作成したプル リクエストを確認するには、[あなたの作業] ダッシュボードの [あなたのプル リクエスト] を確認します。

プル リクエストの作成者がレビュアーを含むプル リクエストを作成すると、コード レビュー プロセスが正式に開始されます。作成時にレビュアーを追加しない場合、あとからいつでもプル リクエストを編集して追加できます。

プル リクエストを作成してレビュワーを追加したら、承認を待ちます。レビュワーがコードを確認してコメントを追加すると、プル リクエストでのディスカッションについてメール通知が送信されます。コメントに返信し、コード レビュー プロセスに能動的に参加することができます。

プル リクエストのレビュワー

レビュー待ちのリクエストを確認するには、[最近の作業] ダッシュボードの [レビュー待ちのプル リクエスト] リストを表示します。レビュアーとして登録されていないプル リクエストに同僚を参加させる場合、ワークスペースのリポジトリの [プル リクエスト] ページに移動します。

ワークスペースのメンバーがユーザーをレビュアーとして追加すると、メール通知が送信されます。プル リクエスト作成の最初の通知のあとは、次のタイミングで通知が送信されます。

• 作成者による更新

• ほかのユーザーからのコメントの追加

• ほかのレビュワーによる承認

• ほかのユーザーによるプル リクエストのマージ

通知を無効化する場合、プル リクエストのウォッチを解除できます。

コード レビューでは、フィードバック、提案、アイデアをコメントとして追加できます。ロジックに問題がないか、すべてのケースが完全に実装されているか、既存の自動化テストを書き換える必要があるか、コードが既存のスタイルガイドに適合しているかどうかなどを確認します。

After your review, if the pull request is ready to be merged (or if you trust the author to resolve your tasks before merging), select the Approve button in the top right. A green checkmark appears next to your name in the Reviewers field after you approve a pull request.

既定のレビュワー

You can configure your repository to automatically add predetermined users to all pull requests by setting up Default Reviewers in your repository’s Settings, which allows you to define a list of users that will always be added to all your pull requests. This can be useful, for example, when a repository has many contributors, but a single set of owners that wish to review any changes.

レビュアーを事前に決定するもう 1 つの方法は、.bitbucket という特別な設定ディレクトリにある CODEOWNERS という名前のファイルで所有者を定義することです。このファイルでは、ソース ブランチで変更されたファイル/ディレクトリを調べ、CODEOWNERS ファイルの所有権ルールを調べることで、どのレビュアーをどのプル リクエストに追加するかをきめ細かく制御できます。コード所有者の設定と使用の詳細については、「コード所有者の設定と使用」ヘルプ ドキュメントを参照してください。