CHANGELOGに silent フラグのバージョン要件を追記

tailwindcss-rails のリリースノートに、silent フラグ使用時に必要な Tailwind CSS v4.3.1 以上というバージョン要件が明示されました。これにより、利用者は正しい Tailwind バージョンを把握したうえで、非エラー出力抑制オプションを安全に有効化できます。

背景

この CHANGELOG の更新は、tailwindcss:build と tailwindcss:watch タスクに導入された silent フラグの要件を正確に示すことを目的 しています。以前の記載では Tailwind CLI の --silent オプションが PR #20100（v4.3.0 後）で追加されたことだけが示されていましたが、実際の利用には v4.3.1 以降が必須 である点が不明確でした。正確なバージョン要件を記載することで、ユーザーはビルド失敗や予期せぬ挙動を未然に防げます。したがって、リリースノートの信頼性とユーザー体験の向上が期待されます。

技術的な変更

CHANGELOG の該当行が 1 行削除され、同等の内容が新バージョン要件を示す形で 1 行追加 されています。削除された文は Tailwind の PR リンクに言及していましたが、追加された文は公式バージョン番号と Issue #618 を参照する形に置き換えられました。

@@ -4,7 +4,7 @@

  ### Improved

 -* New `silent` flag on `tailwindcss:build` and `tailwindcss:watch` tasks to suppress non-error output from the tailwindcss CLI (e.g., `bin/rails tailwindcss:watch[silent]`). Requires the tailwindcss CLI's `--silent` option, which was added in https://github.com/tailwindlabs/tailwindcss/pull/20100 (post-v4.3.0).
 +* New `silent` flag on `tailwindcss:build` and `tailwindcss:watch` tasks to suppress non-error output from the tailwindcss CLI (e.g., `bin/rails tailwindcss:watch[silent]`). Requires Tailwind CSS v4.3.1. [#618](https://github.com/rails/tailwindcss-rails/issues/618) @jordan-brough


  ## v4.4.0 / 2025-10-27

変更の直接的な影響はドキュメントの正確性向上に限られ、実装コード自体は変更されていません。しかし、開発者が silent フラグを有効化する際に必要な Tailwind バージョンを即座に確認できるため、設定ミスによるビルドエラーを避けやすくなります。結果として、プロジェクトのメンテナンス性が向上します。

設計判断

バージョン要件を抽象的な PR リンクから具体的なバージョン番号へ置き換える方針 が採用されました。この選択は、利用者にとって最も直接的で実用的な情報提供を優先した結果であり、後方互換性や情報の鮮度を保つために Issue #618 へのリンクも残しています。ドキュメントの一貫性と可搬性を高める設計判断と言えます。

まとめ

今回の CHANGELOG 更新は、silent フラグ使用時の正確なバージョン要件を明示することで、ユーザーが適切な Tailwind CSS バージョンを選択できるようにした点が主な意義です。ドキュメントの正確性が向上し、今後の機能追加やバージョンアップ時の参照基準として機能します。