プル リクエストの下書き

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

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

You start creating a draft pull request in the same way as you create a regular pull request. When you’re ready to save the draft pull request, select Create as draft.

Check out the more detailed guidelines:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

You review draft pull requests in the same way as you review regular pull requests: you can approve drafts or request changes to them. These reviewer statuses will remain after the draft pull request is marked as ready for review.

Note that until a draft is marked as ready for review, it isn’t eligible for merging, either manually or automatically.

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

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

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

2. Select the Status filter dropdown.

3. Select the Draft checkbox to filter the pull request list to display any draft pull requests.

Drafts will be displayed on the list with other pull requests in the order based on the time of their last update.