CI annotation とは?

CI annotation は、エラー、警告、通知などの型付きメッセージで、workflow が実行について何かを強調するために発行します。annotation は正確なファイルと行を指し示すことができ、diff やサマリーにインラインで表示されます。これにより、失敗や検出結果が生ログを超えて構造化された形で表示される場所を得られます。

なぜ重要か

annotation は、埋もれたログ行を、コードに紐づいた可視で実用的なシグナルに変えます。レビュアーは出力をスクロールする代わりに、正確な行に lint エラーを見ることができます。annotation は workflow command や problem matcher を介して発行されるため、どのツールでもこの方法で検出結果を表示できます。

関連ガイド