Railsガイドのアップグレード

[hachi8833]

大きな流れ

以下のニュースに示されているように、The Rails Foundation主導でRailsガイドの大きな改定が進行している。

• Ruby on Rails — Documentation update: work has begun

docsラベルの付いた以下のissueで進められている。

• Issues · rails/rails

特にrails foundationタグのついた以下のプルリクは、The Rails Foundationの肝いりで大幅な改定が進められている。

• Pull requests · rails/rails

また、次回の安定版Railsリリース（ただしどのバージョンかは示されていない）では、Guidesのスタイルも大幅に見直されることが以下で発表されており、edgeguidesでは既に新スタイルが適用されている。

• Ruby on Rails — Rails Guides get a facelift
  参考: rails/rails · Discussions · GitHub -- 新スタイルに関する議論

前提

• Guidesのスタイル変更は、コンテンツそのものにはほぼ影響しないと予想しているが、Railsガイドが今後Guidesのスタイル変更に追従するかどうかは別途検討が必要。
• Guidesの更新量は多くなることが見込まれるが、コンテンツの変動はしばらく続くと予測される。このため、半端なタイミングで更新翻訳を行うと手戻りが増えると予想される。
• そこで基本的には次期安定版Railsがリリースされるまでは更新翻訳の準備を行うに留める。
  • ただし早期にコンテンツ更新が落ち着いたと思われるGuidesがあれば、先行してRailsガイドの更新翻訳を進めることも検討する。
  • Guidesのコンテンツ更新は文章だけではなく、一部の図にも及んでいるので、図も更新する必要がある。
  • 現時点では、以下の差分がある

参考: Comparing v7.1.3...main · rails/rails

確認すべき点

ドキュメントの改定がどのマイルストーンで区切られるのかを確認する必要がある（現在foundation@rubyonrails.orgに問い合わせ中）。

• 7.1.4 Milestone
• 7.2.0 Milestone
• 8.0.0 Milestone

GuidesのChangelogは現在は空だが、fb6c600を見る限りではGuidesは7.2を目標としているように見える。

• rails/guides/CHANGELOG.md at main · rails/rails

[hachi8833]

現時点で https://github.com/rails/rails/milestone/83 が残り1個になったので、7.2ガイド更新の準備を進めます。

定番更新

• 7.2リリースノート（新規）
• Upgrading Rails

メジャー更新翻訳

• Action Mailbox Basics
• Action Text Overview
• Active Job Basics
• Active Model Basics
• Active Record Basics
• Action View Overview
• Action View Helpers

新規翻訳

下の2つは関連の更新あり

• Getting Started with Dev Containers
  • Getting Started Guide
  • Command Line Guide

[hachi8833]

まだマージされていませんが、7.2マイルストーンで"Tuning Performance for Deployment"ガイドが追加されていました（その後マージ）。

• Add a Rails Guide called "Tuning Performance for Deployment" (second version) rails/rails#51924