📕 Railsガイドが Rails 8.0 に対応しました
2024年11月にリリースされた Rails 8.0 に合わせ、Railsガイドも Rails 8.0 に対応しました!🆙✨
Rails 8.0 は2024年8月にリリースされた Rails 7.2 から間もないこともあって新規ガイドの追加は少なめですが、既存ガイドの改定が多めになっています。
本記事では、改訂されたガイドを含めて注目ポイントを1つずつご紹介していきます。
🆕 Rails 8.0 の注目ポイント
1. 🆕 Strong Parameters の改善
Strong Parameters に`expect` メソッドが追加されたことで、従来の `permit` や `require` よりも書きやすくなり、パラメータ改ざんによる 500 エラー発生も防げるようになりました。
また Action Controller ガイドの Strong Parameters の説明など、ガイド全体で `expect` を使うコードに更新され、scaffold ジェネレータで生成したコントローラでも `expect` が使われるようになりました。
詳しくは以下の Rails API の`expect` 項目などからご確認いただけます。
2. 🆕 Rails 8.0 の主な機能
Rails 8.0 では、Kamal 2 や Propshaft など、プロジェクトをより立ち上げやすくするための機能などが強化されています。
また Rails 8.0 へのアップグレードガイドに注意事項が無く Rails 7.2 からアップグレードしやすくなっている点も、今回の特徴の1つです。
他、細かな更新部分について紹介されている記事もあリます。
なお今後は、半年に1回のペースで新バージョンがリリースされると予告されています。
🆕 新たに追加されたガイド
今回追加されたのは以下のガイドのみとなります。
1. 🆕 Rails 8.0 リリースノート
🆙 大幅に改訂されたガイド
Rails Foundation が進めているドキュメント改善の一環として、Rails 8.0 でも以下の5つのドキュメントが大幅に改定され、読みやすくなりました。なおドキュメント改善は今回の改定後も継続的に進められていく予定です。
以下は、大幅に改訂されたガイドと、その差分となる PR のまとめです。
1. 🆙 Active Record 関連付けガイド
Active Record 関連付けガイドでは、リレーションの画像が更新されました。また構成も大幅に見直され、重複する説明が整理されました。
主な原文更新: [RF-DOCS]Active Record Associations Guide [ci-skip] by Ridhwana · Pull Request #52523 · rails/rails
訳文の主な更新差分:
2. 🆙 Action Mailerの基礎
メーラーの編集方法などが詳しく書き直されています。
主な原文更新: [RF-DOCS] Action Mailer Guide [ci-skip] by bhumi1102 · Pull Request #52905 · rails/rails
主な訳文更新:
3. 🆙 ルーティングガイド
サンプルコードなどが見直され、ルーティングを遅くしないためのヒントなども充実しています。
主な原文更新: [RF-DOCS] Rails Routing Guide [ci-skip] by bhumi1102 · Pull Request #52521 · rails/rails
主な訳文更新: [8.0] routing.mdの原文更新を訳文に反映 by hachi8833 · Pull Request #1728 · yasslab/railsguides.jp
4. 🆙 エラー通知ガイド
文面が見直され、エラー登録/解除の方法などが充実しました。
主な訳文更新:
5. 🆙 フォームヘルパーガイド
複雑なフォームの作成方法が充実しています。
主な原文更新: [RF-DOCS] Action View Form Helpers Guide [ci-skip] by bhumi1102 · Pull Request #51936 · rails/rails
主な訳文更新: [8.0] form_helpers.mdの原文更新を訳文に反映 by hachi8833 · Pull Request #1730 · yasslab/railsguides.jp
🔜 予告: 次に追加・大幅更新されるガイド
現時点の`main`ブランチでは、
・Action Controller「Advanced Topics」の新規追加と
・Active Record バリデーションのガイドの大幅な更新
がそれぞれ予定されています。詳細は以下の PR からご確認いただけます。
🆙 他、更新されたガイド(一部抜粋)
Rails 8.0 のリリースに伴い、コンフィグ設定に関するガイドなど、他にも多くの点が更新されました。以下は更新されたガイドの一部となります。
さらに詳しい更新箇所については、以下のページからご確認いただけます ✅
📕 Railsガイド、協賛募集中!
Railsガイドは多くの協賛企業による支援のおかげで継続的に更新が続けられております。また「過去バージョン閲覧機能」はこれまで有償でのみ提供しておりましたが、協賛企業の増加に伴い、2023年6月より誰でも無料で利用できるようになりました 🙏 💖
過去バージョンの URL を誰とでもシェアできるほか、Rails 7.2 と Rails 8.0 でどう変わったのか確認・検証したい場面などでも役立ちます 📕
Railsガイドでは引き続き『協賛プラン』を通して、Ruby/Rails エンジニアを支援したい協賛企業を募り、Railsガイド内でもご紹介していきます。「ちょっと気になっている」という段階からの相談も歓迎ですので、気軽にお問い合わせいただけると嬉しいです 😌✨
💖 2024年11月時点での協賛企業一覧 (順不同) 💖
📕 今後も継続的に改善していきます
主要なガイドの追加/更新は完了しましたが、Railsガイドでは日々更新を続けています。今後も継続的に更新していくので、何かあれば GitHub の yasslab/railsguides.jp まで気軽に Pull Request を送ってください! 😆✨