見出し画像

📕 Railsガイドが Rails 8.0 に対応しました

YassLab 株式会社

2024年11月にリリースされた Rails 8.0 に合わせ、Railsガイドも Rails 8.0 に対応しました！🆙✨

Rails 8.0 は2024年8月にリリースされた Rails 7.2 から間もないこともあって新規ガイドの追加は少なめですが、既存ガイドの改定が多めになっています。

本記事では、改訂されたガイドを含めて注目ポイントを１つずつご紹介していきます。



🆕 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 など、プロジェクトをより立ち上げやすくするための機能などが強化されています。

https://railsguides.jp/8_0_release_notes.html


また Rails 8.0 へのアップグレードガイドに注意事項が無く Rails 7.2 からアップグレードしやすくなっている点も、今回の特徴の１つです。

他、細かな更新部分について紹介されている記事もあリます。


なお今後は、半年に１回のペースで新バージョンがリリースされると予告されています。



🆕 新たに追加されたガイド

今回追加されたのは以下のガイドのみとなります。

1. 🆕 Rails 8.0 リリースノート


🆙 大幅に改訂されたガイド

Rails Foundation が進めているドキュメント改善の一環として、Rails 8.0 でも以下の5つのドキュメントが大幅に改定され、読みやすくなりました。なおドキュメント改善は今回の改定後も継続的に進められていく予定です。

以下は、大幅に改訂されたガイドと、その差分となる PR のまとめです。


1. 🆙 Active Record 関連付けガイド

Active Record 関連付けガイドでは、リレーションの画像が更新されました。また構成も大幅に見直され、重複する説明が整理されました。


2. 🆙 Action Mailerの基礎

メーラーの編集方法などが詳しく書き直されています。


3. 🆙 ルーティングガイド

サンプルコードなどが見直され、ルーティングを遅くしないためのヒントなども充実しています。


4. 🆙 エラー通知ガイド

文面が見直され、エラー登録/解除の方法などが充実しました。


5. 🆙 フォームヘルパーガイド

複雑なフォームの作成方法が充実しています。


🔜 予告: 次に追加・大幅更新されるガイド

現時点の`main`ブランチでは、
・Action Controller「Advanced Topics」の新規追加と
・Active Record バリデーションのガイドの大幅な更新
がそれぞれ予定されています。詳細は以下の PR からご確認いただけます。


 🆙 他、更新されたガイド（一部抜粋）

Rails 8.0 のリリースに伴い、コンフィグ設定に関するガイドなど、他にも多くの点が更新されました。以下は更新されたガイドの一部となります。


さらに詳しい更新箇所については、以下のページからご確認いただけます ✅

📝 NOTE: Rails 8.0 対応後も継続的に更新しています! 最新の状況については @RailsGuidesJP または GitHub リポジトリからご確認ください…!! 📕✨


📕 Railsガイド、協賛募集中！

Railsガイドは多くの協賛企業による支援のおかげで継続的に更新が続けられております。また「過去バージョン閲覧機能」はこれまで有償でのみ提供しておりましたが、協賛企業の増加に伴い、2023年6月より誰でも無料で利用できるようになりました 🙏 💖

過去バージョンの URL を誰とでもシェアできるほか、Rails 7.2 と Rails 8.0 でどう変わったのか確認・検証したい場面などでも役立ちます 📕

Railsガイドでは引き続き『協賛プラン』を通して、Ruby/Rails エンジニアを支援したい協賛企業を募り、Railsガイド内でもご紹介していきます。「ちょっと気になっている」という段階からの相談も歓迎ですので、気軽にお問い合わせいただけると嬉しいです 😌✨


💖 2024年11月時点での協賛企業一覧 (順不同) 💖

引用元: https://railsguides.jp/#supporters


📕 今後も継続的に改善していきます

主要なガイドの追加/更新は完了しましたが、Railsガイドでは日々更新を続けています。今後も継続的に更新していくので、何かあれば GitHub の yasslab/railsguides.jp まで気軽に Pull Request を送ってください! 😆✨

📝この記事を書いた人: @hachi8833 & @rakudaSanDesu

YassLab株式会社の活動に興味を持っていただければ嬉しいです。こちらからのサポートは Raisチュートリアル、Railsガイドなど各サービスの向上に役立てていきたいと思います💓