JetBrains Space ヘルプ

コードレビューを開始(リクエスト)する

チームメイトにコードレビューをリクエストする人は、通常、次の一連のタスクを実行します。

  1. 変更をコミットしてプッシュするを Git リポジトリにコピーします。

  2. コードレビューを作成します。フィーチャーブランチへの変更をコミットし、それをベースブランチ (メイン、マスター) にマージしたい場合は、マージリクエストを作成します

  3. 査読者を招待するのフィードバックを待ちます。

  4. 課題について話し合うがある場合は、査読者とコメントを交換すること

  5. 課題の解決に取り組み、修正をコミットし、新しいリビジョンを追加するを既存のレビューに反映します。

  6. レビュー担当者が変更を承認したら、すぐにレビューを閉じます。レビューがマージリクエストの場合は、ブランチをマージします。

コードレビューを作成する

  1. プロジェクトに移動すると入力してリポジトリを開きます

  2. コミット数」タブに移動します。最近のコミットが時系列順にリストされます。

  3. リストを下にスクロールするか、フィルターを使用して、興味のあるリビジョンを見つけます。

  4. リビジョンエントリを選択し、「新規コードレビュー」をクリックします。

    createReview.png

    新しいレビューが作成され、開かれます。

    reviewCreated.png

デフォルトのコードレビュータイトルは、レビューに含まれるコミット (または複数コミットレビューの最後のコミット) と同じです。

コードレビューのタイトルを編集し、レビューに説明を追加するには:

  1. コードレビューページの右上隅にある edit-blue.png をクリックします

  2. タイトルを編集し、説明を追加します。

    editCodeReview.png
  3. 保存をクリックします。

    説明は、「タイムライン」タブのレビューコメントの上に表示されます。

次のステップでは、少なくとも 1 人のレビュー担当者をレビューに割り当てる必要があります。

レビュー担当者の割り当て

レビュー担当者をレビュー担当者リストに追加して割り当てます。

レビュー担当者を追加するには:

  1. レビューページで、プラスアイコンをクリックし、ドロップダウンリストから 1 人以上のレビュー担当者を選択します。

    addReviewer.png

    割り当てられたレビュー担当者はレビューページの上部に表示されます。

  2. レビュー担当者として追加した人には、チャットで通知が届きます。

    次に、レビュー担当者が変更の検査を完了するまで待つ必要があります。完了すると通知が届くため、次に進む番です。

レビュー担当者を削除するには:

  • カーソルをレビュー担当者の上に置き、x をクリックします。

    removeFromReview.png

他の人をウォッチャーとして登録する

レビューを購読することで、他の人を招待してアップデートを視聴したり、変更について話し合ったりすることができます。コメントでその人にメンションするだけです。「@」と入力して、リストから人を選択してください。

ステータスを確認してください

コードレビューでは、参加者が順番にプロセスを明確かつ秩序正しく保つように努めます。右側のパネルの自分の名前にあるステータスインジケーターにより、待つべきか行動を起こすべきかがわかります。

authorStatusWaiting.png

灰色は、アクションが必要ないことを示します。レビュー担当者の順番が終了するまで待ちます。

authorStatusRevising.png

オレンジ色はあなたの番であることを示しており、次のようなアクションを実行することが期待されています。

  • 査読者によって投稿されたコメントに返信します。

  • 追加の変更または修正をコミットし、そのコミットをレビューに添付します。

完了したら、右上隅にある提案されたアクションをクリックしてステータスを変更し、レビュー担当者に順番を渡します。

authorStatusEnd.png

自分の名前に空白のステータスがある場合は、レビューが完了し、閉じることができることを示します。右上隅にあるレビューを閉じるボタンをクリックします。レビューがマージリクエストの場合は、マージボタンをクリックしてブランチをマージし、レビューを閉じます。

コメントを投稿する

コメントを投稿して他の参加者に宛てたり、他の参加者が残したコメントに返信したりできます。詳細については、コメントと提案された変更を参照してください。

レビューにさらにコミット (リビジョン) を追加する

次の場合、レビューに複数のコミットを含めることができます。

  • レビューしたい変更は、複数のコミットにまたがっています。

  • レビューのために最初に送信したコミットはレビュー担当者によって承認されませんでした。その後、課題に取り組み、修正をコミットし、承認のために元のレビューに 1 つまたは複数の新しいコミットを添付できます。

このようにして、コミットとディスカッションの履歴全体が 1 つのレビュー内に含まれ、レビューが開いている限り、別のコミット全体で常に表示されます。

コミットリストから別のコミット (リビジョン) をアタッチする

  1. コミットリストで、添付するコミットを見つけて選択します。

  2. 右側のペインで、「新規コードレビュー」ボタンの横にある矢印をクリックし、「既存のレビューに追加」を選択します。

    attachToReview.png
  3. 表示されたリストから、コミットを添付するレビューを選択します。

レビューページから別のコミット (リビジョン) を添付する

  1. レビューページで、変更タブに移動します。

  2. コミットによる変更の横にある plus-add-grey.png をクリックします。

    addCommits.png

    コミットのリストがポップアップ表示されます。

  3. リストから 1 つ以上のコミットを選択し、コミットを追加をクリックします。

    selectAddCommits.png

レビューからコミットを切り離する

  1. レビューページで、変更タブに移動し、コミットによる変更ビューを展開します。

  2. デタッチするコミットを選択します。

  3. 選択したものを切り離すをクリックします。

    detachCommitFromReview.png

査読者の承認

レビュー担当者が変更を受け入れると、チャットで通知されます。解決策はレビューページのタイムラインタブにも掲載され、ユーザーアイコン (緑色で囲まれます) に示されます。

reviewResolutionAvatar.png
reviewResolutionAll.png

コードレビューを終了する

すべてのレビュー担当者が変更を承認した場合、レビューは完了し、レビューを閉じる必要があります。レビューを閉じるには、対応するボタンをクリックします。

closeReview.png

レビュー内のすべてのディスカッションが解決済みとしてマークされている場合、すべてのレビュー担当者が変更を承認すると、レビューは自動的に終了します。

技術的には、コードレビューはどの段階でも終了できます。例: 間違って作成した場合。menu-horizontal.png をクリックしてレビューを閉じるを選択するだけです。

closeReviewFromMenu.png

レビューを追跡する

コードレビューページでは、参加したレビュー、または参加が期待されているレビューを追跡できます。フィルターを使用して、作成者または査読者としてどのレビューに注目する必要があるかを確認します。

gotoReviewsPage.png

このページでは、プロジェクト内のすべてのレビューを表示および検索することもできます。

関連ページ:

リポジトリにコミットする

Space を使用すると、リポジトリファイルをブラウザーから直接編集できますが、一貫してリポジトリに貢献できるようにするには、リポジトリのクローンを作成する必要があります。つまり、ローカルマシン上に作業コピーを設定して IDE で作業するか、リモート開発を使用する必要があります。環境。リポジトリのクローンを作成する前に、次のことを行う必要があります。Git の最新バージョンをマシンにインストールし、コミットユーザー名とメールアドレスを Git に設定します。Space はこのメールを使用してコミ...

マージリクエスト

作業中のブランチをベースブランチ (メイン、マスター) にマージする前に、チームメイトに変更を調べて承認するよう招待するマージリクエストを作成できます。マージリクエストは、次のことを可能にする特別な種類のコードレビューです。2 つのブランチを比較してください。競合がある場合は簡単に発見できます。ブランチをマージするはレビューページから直接アクセスできます (リベースとスカッシュも同様)。マージリクエストを作成する:コミットリストのグラフに従って、マージするブランチを見つけます。ブランチの最上位...

プロジェクトに参加する

あるプロジェクトに貢献を開始したい場合は、そのプロジェクトに参加する必要があります。つまり、そのプロジェクトのメンバーになる必要があります。貢献しようとしているプロジェクトに移動します。すでにメンバーである場合は、プロジェクトのページのプロジェクトメンバーにリストされます。そうでない場合は、プロジェクト管理者に連絡してメンバーシップを依頼してください。プロジェクト管理者を確認するには、プロジェクトページでメンバーウィジェットをクリックします。プロジェクトを探す:すべてのプロジェクトは名前で見つ

リポジトリを探す

リポジトリを見つけるには、を押してリポジトリ名の入力を開始します。あるいは、興味のあるプロジェクトを開いて、そのリポジトリを表示することもできます。一部のプロジェクトには複数のリポジトリが含まれる場合があります。すべて表示し、必要なものを選択できます。プロジェクト内に多数のリポジトリがある場合は、名前でフィルタリングフィールドを使用して必要なリポジトリを見つけます。すばやくアクセスするには、お気に入りにリポジトリを追加します。これはプロジェクト入力ページとサイドバーに表示されます。最終更新日:

リポジトリを検索する

ファイルを探す:リポジトリ内の特定のファイルを検索するには: プロジェクトに移動するをクリックして、検索するリポジトリを開きます。を押して、表示されたダイアログでファイル名の入力を開始します。コミットを見つける (リビジョン):リポジトリ内の特定のコミットを見つけるには: プロジェクトに移動するをクリックし、検索するリポジトリを選択します (複数ある場合)。コミット数タブに移動します。コミットリストの上部にあるコミットのフィルターフィールドを使用すると、コミットメッセージに含まれる単語やフレーズで検...

課題をコミットまたはコードレビューにリンクする

課題を関連するコミット、コードレビュー、マージリクエストにリンクすると、ワンクリックで課題に関連するすべてのデータにアクセスできるようになります。課題内のコミットメッセージを表示したり、コードレビューから課題にアクセスしたりできるため、タブを切り替えることなく作業の進行状況を追跡できます。課題とコミットまたはコードレビューの間にリンクを作成すると、次のエンティティがバインドされ、同期されます。コードレビューにリンクされている課題にはそれぞれのコードレビューページからアクセスでき、コミットにリンク...