On 12 set, 22:22, Mike Gunderloy <[email protected]> wrote: > On Sep 12, 2009, at 5:17 PM, Ryan Bigg wrote: > > > I've started a documentation effort of my own back in June, I've got > > the docs up on a Github repository:http://github.com/radar/how-rails-works > > . Currently it covers only timezones and respond_to for Rails 2.3. > > There was another guy who was going to do Dynamic Finders but he > > hasn't contributed to that recently. > > > I like the idea of version specific documentation. Perhaps we could > > get the docrails team to volunteer for this kind of effort? > > The docrails team has talked about internals documentation several > times, and so far we've felt that we just don't have the resources to > cover that and still do a good job on the external-facing > documentation. I don't believe this will change any time soon.
HI Mike. First, congratulation for your job on railsdoc project! It is a wonderful project! I agree with you that internal documentation should not be dealt in railsdoc. At first, I thought in suggesting a Rails internal guide, but then I realized that it would be outdated faster than the topic about nested templates that I wrote some time ago... It is not just about the docrails team having or not the resources to cover that, but such a documentation should be maintained alongside with Rails internal changes. That would be too difficult to achieve... Best regards, Rodrigo. --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Ruby on Rails: Core" 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/rubyonrails-core?hl=en -~----------~----~----~----~------~----~------~--~---
