Binary Code

As a Rails newbie I spend a lot of time flipping through the books I have, scouring Google, and reading the Rails documentation. So far I think the biggest weakness of Rails has been the docs - they’re a bit obtuse, lack comprehensive examples, and as of Rails 1.2.2 the online docs are out of date.

This is not intended to be an attack - Rails is still so relatively new and progressing so quickly that it’s inevitable the docs lag behind. After all, who wants to write docs when they can write code? And writing good docs is extremely hard (every programmer I know thinks they can write docs, few bother to try, fewer still succeed).

Fortunately there’s a concerted effort to improve the Rails docs. You can check out their progress at http://fearoffish.clientsection.com, Login: guest, Password: guest.

Good stuff!