Re:7 reasons I switched back to PHP after 2 years on Rails -...
by hello_moto on Sunday September 23, 2007 @12:16PM
(#58561)
Correct me if I'm wrong. But I keep hearing (from the community) that the word "well-documented" rarely showed up next to "Rails"
Re:7 reasons I switched back to PHP after 2 years on Rails -...
by DocSavage on Sunday September 23, 2007 @12:57PM
(#58565)
I haven't been on news.YC very long, so maybe that was mentioned as an issue a while ago. When Rails first came out, there was a paucity of documentation. The book "Agile Web Development" came out to meet the need. Now when I go into a bookstore or search through Amazon, I'm shocked by the number of books on Rails and Ruby. Truly amazing. Then there are the self-published outlets like peepcode.com, flexiblerails.com, etc. Rails and Ruby coders are also active bloggers and IRCers. The folks at Caboo.se, in particular, have been working on internals documentation. (http://www.caboo.se/documentation)
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:
If you think rails internals needs more documentation and can help, check out the Rails Documentation project:
Would have been nice to read more about the mismatch points between Rails and legacy code. Was this a legacy DB structure that couldn't be loosely coupled to the Rails side, e.g., exposed as an internal REST service?
I also wonder if others can just as easily extend his code than if he had used a well-documented framework like Rails. In any case, it's impressive he rewrote the whole system (doesn't look like a small web app) in 2 months.