It'd be quite nice if in the API for documentation all method/message names had what they respond with...
It's quite hard to know this sometimes. Julian. for instance, does the ActiveRecord#attributes= method respond with the object, or with the hash of attributes? Julian. On 26/02/2009, at 9:38 AM, Rich Morin wrote: > > At 14:19 -0800 2/25/09, MarkMT wrote: >> Not sure if this is the kind of input you're looking for, >> but my $0.02 fwiw... > > It's all good... > > >> ... a little more architectural documentation with some >> supporting visuals that would make the code a little more >> approachable ... > > It took a while for this kind of information to emerge for > Rails. "Ruby for Rails" (Black) is a start in that direction; > "The Rails Way" (Fernandez) goes quite a bit further. I think > that we're likely to see a new edition of at least the latter > volume after Rails 3 emerges. Some of the Merbish books may > also have relevant content (I certainly HOPE they do! :-). > > This is not to say, however, that it shouldn't be possible to > add some context and/or theory to the current documentation. > My hope, in particular, would be to find a way to integrate it > in some manner with the API documentation. > > -r > -- > http://www.cfcl.com/rdm Rich Morin > http://www.cfcl.com/rdm/resume [email protected] > http://www.cfcl.com/rdm/weblog +1 650-873-7841 > > Technical editing and writing, programming, and web development > > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "merb" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/merb?hl=en -~----------~----~----~----~------~----~------~--~---
