まず警告し、後からエラーにする

2026年3月10日

タグガバナンスは、ビルドを止める前に役立つ監査シグナルとして始められます。

ずれを見えるようにする

チームがタグ語彙を導入したばかりのころ、未知のタグは間違いというより手がかりであることがよくあります。tagGovernance を "warn" にすると、ビルドを継続しながら、語彙とコンテンツが一致していない場所を監査レポートに表示できます。執筆者は、それがタイポなのか、名前変更なのか、正当な追加なのかを判断できます。

タグガバナンスガイドでは、語彙を一度きりのリストではなく、プロジェクトのメンテナンス対象として扱います。そのため、最終的に "strict" へ移行する判断を意図的に行えます。未知のタグでビルドが失敗するまでに、チームはそれらを解決する機会を得られます。

強制はプロダクト上の判断

警告は正しさの弱い版ではなく、異なる導入段階です。小規模なプライベートサイトならすぐにエラーへ切り替えられますが、共有ドキュメントベースでは観察期間を設ける方が役立つ場合があります。重要なのは、ポリシーを明示し、執筆者がローカルで使うのと同じツールで検証することです。