Tech Racho エンジニアの「?」を「!」に。
  • 開発

Rails: api.rubyonrails.orgで過去バージョンのAPIドキュメントを参照できるURLリスト

小ネタで恐縮です。
RailsのAPI検索といえば、複数バージョンを串刺し検索できる以下のAPIdock.comが長らく定番でしたが、惜しくも4.2.7で更新が停止したままです😢。


apidock.comより

api.rubyonrails.orgは名前からして公式のRails APIドキュメントサイトで、Railsの更新も即座に反映されているようですが、惜しくも最新版しか表示できません。


api.rubyonrails.orgより

と、さっきまで思っていました。

しかしたまたま、以下のURLで過去のAPIドキュメントページを表示できることがわかりました。

api.rubyonrails.orgの過去バージョンURL

以下のリストのバージョンのパッチ番号は、それぞれ各メジャー/マイナーバージョンの最終パッチ番号です。

たとえばURLの/v4.1.16//v4.1.15/に変更すると、そのパッチ番号のAPIドキュメントを表示できます(すべてのパッチ番号を確認したわけではありませんが)。

参考: セマンティック バージョニング 2.0.0 | Semantic Versioning

Rails v2.3.11まで遡ると、ドキュメントのスタイルが現在とだいぶ異なっていますね↓。検索窓もありません😓。


api.rubyonrails.org/v2.3.11より

なお、該当メジャー/マイナーバージョンがない場合はhttps://edgeapi.rubyonrails.org/にリダイレクトされます。 edgeapiには現在Rails 6のAPIドキュメントが置かれています。

とはいうものの、api.rubyonrails.orgで複数バージョンのAPIドキュメントを串刺し検索できないことに変わりはありません。もうちょっとナビゲーションが親切だったら...。

Railsガイド英語版でも同じ方法が使える

同じ方法が英語版のRailsガイド↓でもできることがわかりました。

冗長なのでリストにはしませんが、https://guides.rubyonrails.org/https://guides.rubyonrails.org/v2.3.11/のようにすることで過去バージョンのRailsガイドを表示できます。

上記APIドキュメントと同じバージョンがすべてあるかどうかまでは確認していません。少なくともv1.xはないようです。

おたより発掘


CONTACT

TechRachoでは、パートナーシップをご検討いただける方からの
ご連絡をお待ちしております。ぜひお気軽にご意見・ご相談ください。