Meet the Overview page: The pull request home page you actually wantedの意訳です。
あなたのPRには、ホームページがあってしかるべきです。既存のGitプラットフォームでは、ホームページに最も近いものといえば、4つのタブと、自分でつなぎ合わせるステータスウィジェットくらいのものです。
どのPRも、それで何か役立つことをする前に、2つの問いを投げかけてきます。この変更は何なのか?そして、マージを妨げているものは何なのか?いまのところ、これらの問いに答えるには、変更を頭の中でよりよく理解するために、タブの間を行き来する必要があります。
CodeRabbit Review UIの新しいOverviewページは、PRを開いたその瞬間に、1つの画面で両方に答えてくれます。レビュアーは、その変更が何であり、なぜなのかを即座に読み取れます。
作者は、マージまでに残っているすべてを、順位づけされた1つのリストとして受け取れます。この記事では、ページに何があるのか、各部分は誰のためのものなのか、そしてなぜ私たちがPRにはもう1つのタブではなく専用のホームがふさわしいと判断したのかを、順を追って説明します。
CodeRabbit Review UIとは
CodeRabbitのReview UIは、PRを順序立てられたレイヤーへと分解します。1つのフラットなアルファベット順の差分ではなく、変更をまとまりのあるスライスに分け、理にかなった順序で1つずつレビューできるようにします。Overviewページは、その体験への入り口です。レイヤーを1つずつ進んでいく前に、全体像を把握する場所です。
Overviewページには何があるのか(そしてそれぞれ誰向けなのか)
このページは、どのPRにも必ずいる2人のために役立ちます。それを理解しようとしているレビュアーと、それをマージまでこぎつけようとしている作者です。ページは、2人それぞれが投げかけている問いを軸に構成されています。
上部:「このPRは何なのか?」(レビュアー向け)
ページの上部は、変更の1〜2行のAIによる要約から始まります。Gitプラットフォームからそのまま引き出された元のPRの説明と並んで、完全なCodeRabbitウォークスルーも表示されます。これには、変更にフローがある場合、そのシーケンス図も含まれます。
この部分が答える問い: すべてのファイルを読まなくても、この変更は実のところ何をするのか? 差分から意図を逆算するのではなく、すでに全体像をつかんだ状態でたどり着けます。
ページを開く前から分かる、ステータスの判定
左サイドバーのOverviewの項目には、マージ可能かどうかについての、平易な言葉による1つの読み取り結果が示されます。それはマージのブロッカー、CI、PRのチェック、レビューの判断、そしてCodeRabbit自身の指摘を1つの答えへと束ねたものです。
この部分が答える問い: これはマージできるのか、できないなら、どれだけのものが立ちはだかっているのか?何かをクリックする前に、ひと目で分かります。
「要対応（Needs your attention）」(作者向け)
このセクションは、このPRとマージの間に立ちはだかるすべてを1つにまとめたリストで、4つの段階に分類されます。空の段階は隠れるので、このPRに本当に関係するものだけが目に入ります。
あなたの対応が必要なマージのブロッカー:コンフリクト、ベースより遅れているブランチ、変更のリクエストなど、PRをマージできるようにする前にあなたが解消しなければならないものです。
優先度の高い懸念:マージを厳密に妨げはしないものの、リリースする前に見ておくべき深刻な問題です。たとえば、失敗しているCIのチェックや、CodeRabbitの重大（critical）または重要（major）な指摘などです。
保留中のブロッカー:マージを妨げるものの、たいていは自然に解消するものです。たとえば、まだ実行中のCIなどです。通常はただ待って、想定より時間がかかっているときに様子を見に戻ればよいだけです。
マージは妨げないが、見ておく価値があるもの:優先度の低い項目です。たとえば、結論の出なかったマージ前のチェックや、CodeRabbitの軽微（minor）な指摘などです。
この部分が答える問い: これをマージするために、次に何をする必要があるのか?チェックボックス、会話タブ、レビュアーの一覧を、1つずつ確認する必要はありません。
これらのうちいくつかは、いますぐこの場で対応できます。ドラフトをレビュー可能な状態にしたり、CodeRabbitにコンフリクトの解消やCIの修正を頼んだりできます。残りは、プラットフォーム上の該当箇所へ直接リンクしています。
右のレール:PR単位の会話
右側には、PR単位の議論(レビューとコメント)に加えて、チャットエージェントが配置されており、変更についての質問を文脈の中で投げかけられます。
意図的に省いたものが1つあります。行単位のレビューコメントは、ここには表示されません。それらは対象となるコードのそばでこそ意味を持つので、その文脈が存在するレイヤーの中に置かれています。
Overviewページを別に作った理由
GitHubやGitLabにはすでにPRのページがあります。では、なぜCodeRabbitはもう1つ作ったのでしょうか?
Overviewページを別に作ったのは、プラットフォームのPRページが、レビュアーや作者が抱くであろう問いに答えてくれず、その代わりに、自分でつなぎ合わせなければならない素材を渡してくるだけだからです。
PRを理解するには会話タブ、変更されたファイル、コミット、チェックのボックスの間を行き来し、それらすべてを頭の中でつなぎ合わせる必要があります。なぜマージできないのかを知るには、無効化されたボタンやスピナーをじっと見つめなければなりません。情報はすべてそこにあるのに、すべてをレビューするための見通しがそこにないため、理想的な体験とは言えません。
Overviewページは、そのつなぎ合わせをあなたの代わりにやってくれます。それは、2つの問いに答えるPR単位の唯一のホームです。このPRは何なのか、そしてマージできるのか。レビュアーには1つの答えを、作者にはもう1つの答えを。
レビュアーにとっては、要約とウォークスルーがデフォルトでそこにあり、レビューのChange Stackを開いたときに最初に目にするものになります。おかげで、作者の意図をファイルごとに再構築するのではなく、適切なコンテキストとともにすでに全体像をつかんだ状態で差分にたどり着けます。GitHubやGitLabもいまではAIによる要約を提供していますが、それらはオプトインだったり、有料プランの向こう側にあったり、探しに行かなければならないボットのコメントに埋もれていたりします。
作者にとっては、PRがマージできるかどうかの当てものではなく、1つの判定が得られます。その答えはかつて、165行のチェックのボックス、会話タブ、レビュアーの一覧に散らばっていました。Overviewはそれらのシグナルをすべて読み取り、残っているものを順位づけするので、あなたの注意はまっすぐ、対応できるものへと向かいます。
Overviewページはこれからどこへ向かうのか
Overviewページは今日から使えて、すでに私たちの多くがレビューを始める場所になっています。そして、これはまだ始まりにすぎません。
より多くのアクションを、1か所に。 いまはGitHubやGitLabへのリンクになっているカードの多くが、Overview上でそのまま解決できるようになります。ページを離れることなく、CIを修正するためにCodeRabbitのコーディングエージェントのタスクを起動することも含まれます。
完全なPRのタイムライン。 議論のレールはPRの承認、コミット、force-pushなどを含む完全なタイムラインへと成長していきます。
より豊かなPRのダッシュボード。 PRの詳細やデプロイのコンパクトなビューです（これにより、その変更のためのPRプレビュー環境へ直接ジャンプできます）。
Overviewページは、Review UIにアクセスできるすべての方が利用可能です。ぜひご覧いただき、何が全体像を素早くつかむのに役立ったか、さらに今後ページ上で直接対応できるようにしてほしいものは何か、ぜひご意見をください。
