プル リクエストの下書き

プル リクエストの準備が整うまで、不要なフィードバックや偶発的なマージを避けたい場合があります。プル リクエストの下書きを作成することで、作業がまだ進行中であることをチーム明確に伝えることができます。プル リクエストが下書きである間も、Bitbucket のすべてのコラボレーション機能を使用して早期のフィードバックを得ることはできますが、マージは禁止され、ドラフトを準備完了としてマークするまで追加したレビュアーには通知されません。

プル リクエストの下書きを作成する

プル リクエストの下書きの作成は、通常のプル リクエストを作成する場合と同じ方法で開始します。プル リクエストの下書きを保存する準備ができたら、[Create as draft (下書きとして作成)] を選択します。

より詳細なガイドラインを次に示します。

  1. オープンなリポジトリから、[作成] ボタン > ドロップダウン メニューの [このリポジトリ] セクションで [プル リクエスト] の順に選択します。

  2. プル リクエスト フォームに入力します。

    1. ソース: ソース ブランチおよびリポジトリは、マージしたいコード変更を行った場所です。

    2. 宛先: 宛先側のリポジトリとブランチはソースのマージ先です。

    3. タイトルと説明: 両方ともメール通知に記載されていて、タイトルはプル リクエストのリストに表示されます。

    4. レビュアー: 効果的なフィードバックを提供し、他のメンバーに変更について知らせるレビュアーを追加または選択します。プル リクエストが準備完了としてマークされると、プル リクエストの下書きに追加されたレビュアーに通知されます。注: プル リクエストの下書きを作成するだけの場合、レビュアーの追加は省略しても構いません。レビュアーは後で追加できます (たとえば、下書きを編集してレビュー待ちにしたときなど)。

    5. 差分とコミット: 新しい変更を比較して関連コミットを確認する場合は、これらのタブをチェックします。

  3. [Create as draft (下書きとして作成)] を選択します。

プル リクエストの下書きが作成され、作業を続行できます。

プル リクエストの下書きをレビュー待ちにする

その後のレビューやマージのためにコードを共有する準備ができたら、プル リクエストの下書きをレビュー待ちとしてマークできます。これを行うには、[Mark as ready (準備完了としてマーク)] ボタンを選択します。

この段階で、手動でプル リクエストにレビュアーを追加することもできます。また、[レビュアー] フィールドの下にある対応するクイック追加ボタンを使用して、自動的に追加された既定のレビュアーやコード所有者を管理することもできます (該当する場合)。

通常のプル リクエストと同じように、すぐに下書きのレビューとマージが可能になります。アクティビティ履歴では、プル リクエストがレビュー待ち (READY FOR REVIEW) としてマークされます。追加したレビュアーには、プル リクエストがレビュー待ちになったことを知らせるメール通知が届きます。

通常のプル リクエストを下書きに変換する

プル リクエストを下書きに戻してそのまま作業を続ける場合は、プル リクエストのアクション メニュー (...) に移動して [Mark as draft (下書きとしてマーク)] を選択します。アクティビティ履歴では、プル リクエストが下書き (DRAFT) としてマークされます。

プル リクエストの下書きを確認

プル リクエストの下書きは、通常のプル リクエストをレビューする場合と同じ方法でレビューします。つまり、下書きを承認したり、下書きに対する変更をリクエストしたりできます。これらのレビュアー ステータスは、プル リクエストの下書きがレビュー準備完了としてマークされた後も維持されます。

下書きがレビュー準備完了としてマークされるまで、手動または自動でマージすることはできません。

プル リクエストの下書きを表示

既定では、プル リクエストの下書きは、Bitbucket インスタンスのプル リクエスト リストに表示されません。プル リクエストの下書きを表示するには、次の手順を実行します。

  1. プル リクエスト ページに移動します。

  2. [ステータス] フィルター ドロップダウンを選択します。

  3. [下書き] チェックボックスを選択することで、プル リクエスト リストをフィルタリングしてプル リクエストの下書きを表示します。

下書きは、最終更新日時に基づいて他のプル リクエストとともにリストに表示されます。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。