誰でも読めないとダメ？ - idesaku blog

NEWS

screenshot

かつて、ドキュメントを書く際に上司によく言われたものである。 「誰が読んでもわかるように書きなさい」 当時はなるほど、そうしないと、と思ったが、今はこんなの時間の無駄だと思っている。 ソフトウェアの詳細設計書を非エンジニアでも読めるように書く、というのは時間の無駄でしかない。例えば、スーパーのレジ打ちのおばちゃんにも読めるような設計書を作るこ...

http://d.hatena.ne.jp/idesaku/20080112/1200125587

確かに
まったくー。Rails初心者には「ググって読みまくれ」という言葉とともに「優しいRailsの育て方」を渡している。
同じことを書こうとしてたww。@employeesとみてインスタンス変数のList<Employee>という情報を脳内補完するのがRails脳

http://b.hatena.ne.jp/entry/http://d.hatena.ne.jp/idesaku/20080112/1200125587