News for hackers. Stuff that matters.
Re:7 reasons I switched back to PHP after 2 years on Rails -... by sbraford on Monday September 24, 2007 @07:40AM (#58846)
In the rails API docs (api.rubyonrails.org) next to each function you can click 'show source' to see what's going on under the hood. I hardly have to do this.

But when I do, it's usually just 5-20 lines of code that's not that complex to grok. (but you're right, not many comments inline) It would not be fun to try and decipher RoR internals as a new ruby programmer.

Re:7 reasons I switched back to PHP after 2 years on Rails -... by DocSavage on Monday September 24, 2007 @03:56PM (#59040)
There's also the caboose edge API documentation. It's updated 3x per day from the most recent rails edge code and has all the private (#:nodoc) methods exposed:

http://caboo.se/doc.html

If you think rails internals needs more documentation and can help, check out the Rails Documentation project:

http://www.railsdocumentation.org/