The other day one of my team members was complaining about the lack of
documentation in Ruby on Rails. I had to think for a minute because I
never had problems finding information I needed. It finally occurred
to me that the ruby development and documentation cycle is very
different than Java's.
First of all, ruby code *is* documentation. The constructs,
conventions and style used in ruby (...