新人エンジニアに読んで欲しい英語ドキュメントまとめ (Ruby/Rails編)

こんにちは！エンジニアの川崎です。

嬉しいことに、Wantedly開発チームの仲間は2013年の1年間で2倍に増えました。2013の最初には自分、 awakia と reikubonaga の3人でしたが、デザイナなのにXCodeも使いこなす ferasyahin、 Chef使いのプロダクティビティ・エンジニア spesnova、それからこのブログのデザインもやってくれたエンジニア imaimiami の加入で合計6人になりました。最近ではさらに kento や shin-en がインターンとして活躍してくれています。

Wantedlyに入社してくるエンジニアは、なぜかRubyもRailsもやったことのない人ばかりなので(自分もそうでした)、今日はそんな彼ら新人のために、Ruby/Railsで開発をするときに役立つページをまとめてみました。

初めてRails開発をする人に参考にして欲しいと思います。

チュートリアル

Ruby on Rails Tutorial: Learn Web Development with Rails

まず、全くRailsをやったことがない場合は適当なチュートリアルをひと通りやるのがオススメです。有名なのはRails Tutorialです。3.2系と4.0系の両方対応していて、最近では有志によって日本語翻訳も公開されました。git入門やHerokuへのdeployも少しだけカバーしているので、これをやっておくとWantedlyでの開発フローにスムーズに参加出来ます。

Rails Guides & APIs

Ruby on Rails Guides

少しRailsの基本を理解したら、公式のRails Guidesをさっと眺めておくとよいでしょう。トピック毎に基本＋αの情報が調度良い分量でよくまとまっています。最初は全部目を通せなくてもどんなトピックがあるのかだけは知っておくと、後々の開発で振り返りやすいです。ちなみに、masterブランチのEdge Guidesも存在します。

Ruby on Rails API

公式のRails APIページも良く出来ています。メソッド名でインクリメンタルサーチができるので、個人的にはこれを愛用しています。

Rails Style Guide

コミュニティによって作られたRailsのベスト・プラクティス集としてRails Style Guideがあります。必ずしも完璧に従う必要はないですが、良いとされている書き方を知っておくことは役に立つでしょう。

Ruby

Ruby 2.1.0 Core API / Ruby 2.0.0 Core API

Rubyのリファレンスとしてはruby-doc.orgのものを個人的には参照しています。こちらもクラス名やメソッド名でインクリメンタルサーチができます。Array, Hash, Enumerable, Stringクラスあたりは見ておくと幸せになれると思います。メタプログラミングに興味があればClass, Module, Kernel, Object, BasicObjectクラスあたりも見ておくとよいでしょう。

Ruby Style Guide

Rails Style Guideと同様に、コミュニティによって作成されたRubyのStyle Guideです。

RSpec

RSpec - Relish

Wantedlyでは自動テストのフレームワークにRSpecを使っています。 Railsでの開発に慣れてきたら、RSpecについても時間をとって学習しておきましょう。テストを書くことに対して感じる精神的なハードルを下げておかないと、自動テストの重要性を頭で理解していても、面倒臭がってテストを書かなくなってしまいます。

自動テスト重要。

Better Specs

RSpecのベスト・プラクティス集です。BADな書き方とGOODな書き方の実例がしっかり書いてあって実践的。

最後に

Railsはバージョンアップ毎の変化がかなり大きいフレームワークです。2013-12-26現在の最新は4.0系で、現在は次期バージョンの4.1.0 betaが公開されてます。Wantedlyでは3.2系を使っているので、ドキュメントやブログなどを読んで調べ物をするときに、どのバージョンが対象なのか、いつ頃の記事なのかを注意してみておかないと、バージョン間の非互換性に悩まされることになるので注意です。

体感的には2012年より前の文章は参考にしないほうがいいと思ってます。おなじ理由で、1次ソースでない日本語ドキュメントも古くなっている可能性があるので、出来るだけ英語のドキュメントを読む癖をつけておくのがよいでしょう。

それではよいRails開発を！

追伸

Wantedlyでは新オフィスで、毎週木曜18:00〜もくもく会を実施しています。ご興味ある方はこちらから参加ください

Wantedly Engineer Blog