Re^4: what does 1; does?

To be fair, the reason Ruby had such lousy English documentation is that it originated in Japan.

There's no excuse for the state of the core Rails documentation, however.

Comment on Re^4: what does 1; does?

Replies are listed 'Best First'.
Re^5: what does 1; does? by djberg96 (Acolyte) on May 06, 2008 at 17:57 UTC
It's kind of a lose-lose situation for any open source software, isn't it? If the core documentation is great people will complain that the books are a waste of money, since you can get everything from the documentation. If the core documentation is poor, people will complain that they're pumping the book market.	[reply]
Re^6: what does 1; does? by chromatic (Archbishop) on May 06, 2008 at 20:16 UTC
Very true. For all of the flaws of POD and the organization of the Perl core documentation sometimes, I think it's really spoiled us. It can be very difficult to compete with that documentation in a book. On the other hand, someone put a lot of work into the API browser for Rails, and for the Rails projects I did, I found it almost unusable. (Then again, I found the first Rails book almost useless too. I'm picky.)	[reply]