CodeStreamへのフィードバックをリクエスト

New Relic CodeStream のフィードバックリクエストは、従来のエンドオブサイクルのコードレビューに使用するのに十分な強力な機能を備えていますが、同時に非常に簡単で柔軟性に富んでいるため、開発プロセス全体を通して、進行中の作業に対する迅速なフィードバックを得るために使用することができます。さらに、コミットされていない変更に対してもフィードバックリクエストを使用することができます。

従来のコードレビューは、開発サイクルの最後に行われ、変更のマージを行う際に行われていました。サイクルの終わりに行われるコードレビューは、チームメイトの負担が大きくなるだけでなく、問題の発見が遅すぎて、スケジュールを大幅に短縮するか、技術的負債を抱えるかのどちらかを選択しなければならなくなる危険性があります。

CodeStreamは開発サイクルのどの時点でも、スタブ関数を作成しただけのプロジェクトの初期段階から、進行中の作業の中間段階、あるいは完成したプロジェクトの最終レビューに至るまで、フィードバックを可能にします。CodeStreamは、プッシュされたコミット、ローカルでのコミット、ステージングされた変更、保存された変更など、現在のステータスを共有するための複雑な作業を処理します。チームメイトは、アプリケーションを切り替えることなく、ブランチを切り替えたり変更をプルすることなく、自分のIDEからフィードバックを提供することができます。

開発サイクルの最後に行われる正式なコードレビューやプルリクエストに至るまでには、問題が提起され、議論され、解決されているため、苦痛ははるかに少なく、形式的なものとなっているのです。

IDEでフィードバックを要求するためのCodeStreamの使い方については、YouTubeのショートビデオ（4分25秒）をご覧ください。

フィードバックリクエストUI

New Relic CodeStream の「フィードバックリクエスト」セクションには、自分に割り当てられた、または自分がリクエストした未解決のフィードバックリクエストと、承認された、または変更がリクエストされた最近のフィードバックリクエストがすべて表示されます。

フィードバックリクエストをクリックすると、レビューに参加したり、あなたの作品に対するチームメイトのコメントを見ることができます。

フィードバックのお願い

ご意見を伺うため。

• CodeStreamペインの上部にある「 + Create 」ボタンをクリックします。
• フィードバックリクエスト セクションのヘッダーにある「 + フィードバックリクエスト 」ボタンを選択します。管理者であれば、歯車のアイコンも表示され、 フィードバックリクエストの割り当て と承認が組織でどのように機能するかを制御することができます。
• キーボードショートカット（ctlr+shift+/ r または ctrl+/ r on a Mac ）を使用することも可能です。

ワンクリックで、最後のコミットメッセージ、ブランチ名、または チケットを選択して作業を開始した場合は 、チケットタイトルに基づいてフィードバックリクエストに名前を付けることができます。CodeStream は、あなたがエディタで現在選択しているファイルのリポジトリ/ブランチの変更に対するフィードバックを要求していると仮定します。IDE で複数のリポジトリを開いている場合は、フィードバックリクエストフォームの一番上にあるリポジトリのドロップダウンから変更することができます。

フィードバックリクエストの設定によっては、CodeStreamが特定のレビュアーを提案することがあります。変更されたコードのコミット履歴に基づいて、CodeStreamのチームにまだ所属していない人が提案されることもあります。その場合、その人にメールで通知されます。レビュアーの名前にカーソルを合わせると、詳細が表示されたり、レビュアーを削除することができます。複数のレビュアーが割り当てられている場合、そのうちの誰かがレビューを承認するのか、それとも一人一人が個別に承認しなければならないのかを決定するオプションもあります。詳しくは、 フィードバック設定の方法について をご覧ください。

プルリクエストで変更されたファイルを探索する

Changed Files セクションには、追加、削除、変更されたすべてのファイルがリストアップされています。フィードバック・リクエストを送信する前に変更内容を確認したい場合は、ファイルをクリックすると差分が表示されます。

チェックインしたバイナリファイルなど、レビューに適さないファイルがある場合、任意のファイルにカーソルを合わせて x をクリックすると、そのファイルをフィードバック要求から除外することができます。そのファイルは、フォームの下のリストに移動されます。新しいファイルは、デフォルトでフィードバック要求から除外されますが、リスト内のエントリにカーソルを合わせて、 + 、追加することができます。

除外したファイルにカーソルを合わせてゴミ箱をクリックすると、そのファイルを今後のすべてのフィードバック要求から永久に除外することができます。ファイルを永久に除外すると、リポジトリに .codestreamignore というファイルが作成されます。チームメイトもこれらのファイル（例えば、 package-lock.json やその他のシステムで生成されたファイル）を除外したいと考えている場合は、そのファイルをコミットしてプッシュすることで、チームメイトもそのファイルを利用できるようになります。

選択されたファイルの変更点は4つのカテゴリーに分類され、フィードバックリクエストに含めたい内容を正確に選択することができます。これには、プッシュされていない、あるいはコミットされていない変更も含まれます。

4つのカテゴリーがあります。

• 変更の保存
• 段階的な変化
• ローカルコミット
• 押し出されたコミット

プルリクエストのコミット

コミットは、 Local Commits と Pushed Commits のセクションで降順に表示されます。あるコミットのチェックを外すと、そのコミットに先行するすべてのコミットのチェックが自動的に外れます。言い換えると、フィードバックリクエストに含まれるコミットは連続していなければなりません。デフォルトでは、自分のコミットだけがチェックされますが、どのコミットもレビューに含めることができます。

オプションとして、フィードバックリクエストをSlackまたはMicrosoft Teamsで共有することができます。

フィードバックリクエストを送信すると、アクティビティフィードでチームメイトに通知され、レビュアーに指定された人には@が表示され、メールでも通知されます。

フィードバックリクエストの設定

デフォルトでは、フィードバックを要求した人が承認の動作を決めることができますが、組織のすべてのフィードバック要求に対するデフォルトの動作を設定することもできます。

• レビュアーの人数に関係なく、どのレビュアーも を承認することができます。
• すべてのレビュアーが個別に承認する必要があります 承認されたとみなされる前に、すべてのレビュアーが承認する必要があります。
• レビューを依頼したデベロッパーは、 依頼を承認することを決定します。

また、CodeStreamがレビュアーを提案するかどうか、どのように提案するかを決めることができます。

• ラウンドロビン は、組織内のすべての開発者を循環させます。
• Random は、フィードバック要求を組織内の任意の開発者にランダムに割り当てます。
• Authorship オプションは、変更の影響を受けるコード行を書いた開発者や、ブランチにコミットした可能性のある他の開発者に基づいて、最大 3 人のレビュアーを提案します。

フィードバック

CodeStreamのフィードバックリクエストの最大の特徴は、チームメイトに自分のコードを見てもらうことで、彼らに余分な負担をかけないことです。ブランチを切り替えたり、変更を取り込んだりするために自分の仕事を脇に置いておく必要はありませんし、IDEを離れる必要もありません。適切なリポジトリを持っていれば、フィードバックリクエストを開いて、あなたの変更点のレビューを始めることができます。

Changed Files セクションの任意のファイルをクリックして、変更点を確認します。変更点はエディタ上に diff で表示されます。IDE のネイティブナビゲーションや、IDE 上部の上下矢印をクリックすることで、ファイルの変更点を順に確認することができます。JetBrains IDE の場合、CodeStream はサイドバイサイドの diff ビューアのみをサポートします。

通常、差分はフィードバックリクエストに関連したブランチ (機能/トピックブランチなど) の変更点を、機能ブランチが作成された時点でのベースブランチに対して表します。CodeStreamの差分では、開発者がフィードバックリクエストにすべての変更を含めていない可能性があるため、必ずしもそうではありません。その結果、差分を取るファイルのバージョンには、ベースブランチにない変更点が含まれていることがあります。これは、継続性を持たせるために重要なことです。

コメント・変更依頼

変更点について一般的なコメントがある場合は、 フィードバックリクエストのスレッドに返信を追加してください。:

• 実際の変更点についてコメントしたい場合は、差分の右側からいくつかのコードを選択し、選択したコードの横にあるCodeStreamペインに表示されるコメントボタンをクリックしてください。
• また、コードを選択した後にキーボードショートカット（ctlr+shift+/ c または ctrl+/ c on a Mac ）を使用することもできます。

ファイルの全文脈がわかるので、変更されたコードの行だけをコメントするように制限されることはありません。たとえば、ファイルの他の部分にも作業が必要であることに気づいたり、単に参照したいだけであることに気づいたりするかもしれません。

一般的なコメントであれ、コードに関するコメントであれ、変更要求としてマークすることで、変更を承認する前にそれが必要であることを開発者に知らせることができるのです。

フィードバック中に、チェンジセットに含まれないファイルにコメントすることもでき、そのファイルはレビューへの返信として追加されます。これは、改善が必要なコードベースの別の場所をチームメイトに指摘するのに役立ちます。

変更要求の承認

フィードバックリクエストに関連するすべての変更要求は、ディスカッションスレッドの一部であるだけでなく、上部のセクションにまとめられます。作業が完了したら、ここに完了マークが付けられます。

• 上部にある緑と赤のボタンを探して、変更を承認するか、追加の変更を要求してください。
• 未解決の変更要求がある場合、承認ボタンが青いボタンに変わり、番号が表示されます。この場合でも変更を承認することはできますが、未解決の作業があることを認識しておいてください。
• 複数のレビュアーがいて、それぞれからの承認が必要な場合、CodeStreamでは未承認の承認がある場合は非常にわかりやすくなっています。右上の青いボタンは、未承認の数を示しています。レビュアーのヘッドショットに表示されている緑色のサムズアップは、あなたの変更がすでに承認されたことを示しています。

コード変更の追加

典型的なワークフローは、レビューアがコメントや変更点を提案し、開発者がそのフィードバックに応えてコードをさらに変更するというものです。このプロセスを継続するには、青い Amend ボタンをクリックして、変更を追加します。

• 最初にフィードバックリクエストを送信したときと同様に、保存された変更とステージングされた変更、ローカルコミットとプッシュされたコミットから選択できます。未解決の変更要求もリストアップされるので、更新によって対処されたものに印をつけることができます。

• デフォルトでは、レビューアがフィードバックリクエストに戻ったとき、各ファイルの差分を調べながら、チェンジセット全体（すべてのアップデートにわたる変更点など）を見ることになります。また、個々のアップデートの差分も見ることができます。

フィードバック依頼を承認する

フィードバックレビューのプロセスは、変更の最終的な承認を得るために必要なアップデートの数だけ続けることができます。フィードバックリクエストが承認されると、CodeStreamの中から プルリクエスト を作成して、コードをマージすることができます。