016 2007年、最首社長は言った　「全エンジニアにRuby on Rails教育を！」 - EC-One ナレッジセンターレスキューサービスブログ

こんにちは、id:EC-OneのAkiです。

各所で花火大会も行われ、夏本番！という感じですね。EC-One（イーシー・ワン）では、毎年恒例の江戸川花火大会見物も行いました。
これで高校野球の放送も始まったら、スイカを食べながらずっと見てしまいそうです。

2007年度の初めにナレッジセンターが始まったときのこと

EC-Oneで社内向けにナレッジセンターを始めた2007年度のこと、「ナレッジセンターとは何なのか」「それをどういう活動で表現していくのか」を担当の開発部長やメンバーと一緒に考えていた時に、担当役員だった社長から、ミッションのひとつとして与えられたのが「全社員がRuby on Railsをやれるようにする」でした。

当時のEC-OneはとあるB2CサイトのRuby on Rails(以下Rails)での開発をたった7週間という短期間で実現したことで、Railsの可能性に自信を持って、後続の案件をいくつか手がけているところでした。
その後もRailsが広がっていくだろうと予想すると、このタイミングでの全社員へのRails教育は必要不可欠な事だったのです。

また、会社全体としてRubyをやっていくんだ、という会社の方向性を社員全員に共有し、実感してもらうことも、裏側の目的としてありました。

教材準備

そこでナレッジセンターが「なるべく教材作りに時間とお金をかけず、受講者にもなるべく受講時間の負担をかけない」という考えで用意した教育コンテンツは「市販の書籍を使って2日間で説明」というものでした。

そこで当時選んだ本がこちらです。

実践 Ruby on Rails Webプログラミング入門―無駄なく迅速な開発環境

作者: 伊尾木将之,長瀬嘉秀,倉貫義人,松本哲也
出版社/メーカー: ソーテック社
発売日: 2006/09
メディア: 単行本
クリック: 18回
この商品を含むブログ (11件) を見る

この本を選んだ理由は以下の通りでした。

出版されたばかりで内容が(当時としては)新しめ
1冊で「Ruby文法」「Rails」「ハンズオン」の全てがまかなえる
さほど分厚くなく2日間で終えるのに適量

正誤表と補足

ところが、ナレッジセンターがその本の内容を自分で試してみたり人に教えたりしようとしてみると、この本には簡単な間違いや説明なしに使われているテクニックが多数ありました。
そこで、間違いについては以下のような正誤表を作って受講者に配布しました。

「実践 Ruby on Rails Webプログラミング入門」正誤表 2007/9/1

○：大したことではない
△：ちょっとしたこと
×：重大なこと (deprecatedも含む)

P.21 ○
誤：WEBrcik
正：WEBrick

P.25 get_text.rhtml、P.26 図1-11 ○
URLが「Message」とあるが、小文字で良い。
(URLはどちらでもよいが、他のページは小文字なので)

P.26 ×
誤：@params
正：params
参考：http://www.yotabanana.com/lab/20061127.html#p02

P.26 ×
最初にアクセスするURLが書いていない。以下になる。
http://localhost:3000/message/get_text

P.26 ○
図1-10はgetTextではなくget_text。
図1-11はdisplayTextではなくshow_text。

P.34 ○
case文の章に「swicth」とあるが正しくは「switch」。

P.34 △
case文のコード例で「flag」という名前の変数なのに「case1」等の文字列が入るのはおかしい。

P.39 ○
Bandクラスに「Freddy」とあるが、フレディ・マーキュリーはQueenのシンガーなので、Bandクラスにあるのはおかしい。

P.43 ○
誤：今まで何度となく出てきて「puts」
正：今まで何度となく出てきた「puts」

P.46 attr_writerのサンプルソース △
誤：attr_writer:name
正：attr_writer :name

P.61 ○
「matz」が説明なしに登場しているが、Rubyを作ったまつもとゆきひろ氏を指す。 → http://www.rubyist.net/~matz/

P.88 ×
CREATE TABLEにおいてテーブル名やカラム名が「'」で囲まれているが、これがあるとエラーになる。
(「'」がつくのは、MySQL Query Browserのテーブル作成確認画面等の表示の際)

P.88 当該ページ第3節1行目 ○
誤：Aciton
正：Action

P.100,P.104,P.108,P.113,P.122,P.124
誤：
require "rubygems"
require_gem "activerecord"
正：
require 'active_record'
※require 'rubygems'が不要なのは、インストーラがWindows環境変数RUBYOPTを設定した為。
  その為、Windows以外ではrequire 'rubygems'が必要となる場合がある。

P.101 ×
「my_customer.delete(1)」とあるが、deleteはクラスメソッド(特異メソッド)なのでインスタンスに対して呼べない筈。
(ちなみにJavaのクラスメソッドはインスタンスに対しても呼べる)
「Customer.delete(1)」とすべき。

P.103 ○
「p my_customer.basket.name」とあるが、左ページのクラス図では買い物かごに名前というカラムは
ない。

P.107 ×
customersテーブルにprefecture_idが14のレコードをinsertしようとすると外部参照制約エラーとなる
事前にprefecturesテーブルのidが14のレコードをinsertしておく必要あり

P.120 1行目 ○
誤：Validiator
正：Validator

P.134,161,211,212,225,232 ×
誤：
<%= start_form_tag 〜 %>
〜
<%= end_form_tag %>
正：
<% form_tag 〜 do %>
〜
<% end %>

P.151,159,204 △
誤：@content_for_layout
正：yield

P.169 ×
誤：map.connect 'programid/:'programid', :controller => 'sample', :action => 'index'
正：map.connect 'programid/:programid', :controller => 'sample', :action => 'index'

P.169 ×
誤：<%= link_to '情報登録', :action => 'entry', :'programid => program.id %>
正：<%= link_to '情報登録', :action => 'entry', :programid => program.id %>

P.169 ×
誤：http://localhost:3000/sample/entry?programid=XXXXXXX
正：/sample/entry?programid=XXXXXXX

P.176 △
rake -T・rake --tasksは、railsアプリケーションのディレクトリで実行する
必要がある。

P.177 8行目 ○
誤：「app/test」
正：「test」

P.182,209,210,221,223,231 ×
誤：rake migrate
正：rake db:migrate

P.182 中央付近の行 ○
誤：schma_info
正：schema_info

P.198 ×
誤：create database webnote_development;
正：create database webnote_development character set utf8;

P.201 リスト 7-4 ×
誤：webnote2_development
正：webnote_development

P.201 リスト 7-5 ×
誤：@headers〜
正：headers〜

P.202 リスト7-6 ×
誤：(memopages.rb)
正：(memopage.rb)

P.202 リスト7-6・P.213 リスト7-14 ×
human_attribute_nameは既にdeprecated。
しかし、その代りのhumanizeとは単純置換が出来ず、使用方法も難しい為、
今回はdeprecatedを承知でhuman_attribute_nameを使用するものとする。

P.203 ×
誤：update_atという名前のカラム
正：updated_atという名前のカラム

P.212 △
リスト7-12で3つめののforが「user_password」となっているが、
正しくは「user_password_confirmation」。

P.213 △
リスト7-13でflash[:notice]に値をセットしているが、P.211のindex.rhtmlにその表示処理がない
(P.215 リスト7-19で追加される)

P.213 ○
リスト7-14に「名前」とあるが、画面上では「ユーザ名」

P.214 △
Aptanaでリスト7-15を書くと呼出先メソッドがないので警告が出る
7-16をやれば消えるので、7-16を先に書いた方が良い

P.220(リスト7-22) ×
誤：find_first
正：find(:first)

P.220(リスト7-22) ×
誤：find_all
正：find(:all)

P.221(リスト7-23)・P.231(リスト7-40) ×
誤：:dependent => true
正：:dependent => :destroy

P.222(リスト 7-26)・P.227(リスト 7-35) ×
誤：:post => true
正：:method => 'post'

P.223 リスト7-28 ○
誤：004_add_column_publicの修正
正：004_add_column_public.rbの修正

P.230 リスト7-38 ×
user_id・memopage_idがstringになっているが、integerとすべき。

P.232(リスト7-42) ×
本メソッドの追加位置は少なくとも「private」指定よりも前でなくてはならない。

P.233(リスト7-44) △
誤：
show.html
正：
show.rhtml

P.233(リスト7-44) △
書き換える前に、P.234のリスト7-45を作成した方が良い。

P.234(リスト7-46) ×
誤：
<%= form_remote_tag 〜 %>
〜
<%= end_form_tag %>
正：
<% form_remote_tag 〜 do %>
〜
<% end %>

P.239 ○
誤：attr_wroter
正：attr_writer

以上

上記の正誤表は自由に使っていただいてかまいませんが、あくまでナレッジセンターが作成したもので、出版社であるソーテック社や著者の皆様が公式に出されているものではありません。その点はご了承下さい。*1

この正誤表を使うと共に、説明なしに使われているテクニックや説明を厚くしたい箇所については、その場で補足しながら説明する事にしました。

こうやって「間違いが多い」「説明なしに使われているテクニックが多い」と書くと、ちょっと技術本としては難があるように聞こえてしまうかもしれませんが、基本的な知識をほんの2日間で一通り学習できる、という点では今でも「いい本を選択した」という思いは変わっていません。
ちなみに出版社や著者の方にメールや電話で「間違いを直して内容に補足をして出しなおしませんか」というお話もしてみましたが、思うように話は進まず... 今となってはRailsもかなりバージョンアップしているので、折角いい本なのだから最新のRailsにそった内容にして出しなおすといいのになぁ、と個人的には思っています。

この本を使って、2007年度中にかなりの人数のエンジニア*2が無事、Ruby on Railsの教育を受講する事が出来ました。

Rubyビジネス・コモンズでの発表

この社内講習を通して得られたのが「Javaで開発をしている人間がRubyを学ぶとき、ここにつまづきやすい」というポイントでした。
そこで、ナレッジセンターでは上記の本と社内講習を行って得た知識を元に、JavaとRubyの違いについて簡単にまとめを行い、Rubyのコミュニティでそれを発表しました。
特にJava言語を主に使ってきた人たちに取ってRubyのどの部分に驚きを感じるか、という視点での資料です。2008年2月当時のものですが、「Java使いから見たRubyの特色」というタイトルでSlideBoomにアップしておきましたので、よろしければご覧になってみてください。

（SlideBoomのEmbedははてなダイアリーには貼れなかったので、画像をリンクにしておきます）

上記の資料と2007年度のRuby on Rails社内教育が非常に有効だったという事は、つい先日社外の講師(JRubyのコア開発者Thomas Enebo氏)を招いて社内セミナーを開催した際に、参加した社員が積極的にコアな質問を投げかけていたことからも、実感することができました。もちろん、実案件ではもっともっといろんな知識が必要ですが、それはプロジェクトの組閣時に「実案件の経験のあるメンバー」と「教育は受けたが実案件の経験はないメンバー」とを組み合わせることでカバーしています。

ナレッジセンターでは「社内でRubyの開発者を育てたいけれど、教育プログラムを作れる人がいない...」「Rubyの開発案件を受注したいけれど、実開発の経験がないので、何かあったら質問出来る技術者を探している」というお悩みのご相談にのります。トライアルで質問を無料で受け付けるキャンペーンも実施しておりますので、お気軽にお問い合わせ下さい！