Such as http://guides.rails.info ? That's all part of the docrails stuff.
Anything other than contributing to those would be completely redundant, in my opinion. :P --Jeremy On Thu, Oct 30, 2008 at 11:51 AM, Daniel Schierbeck <[EMAIL PROTECTED]> wrote: > > I'm thinking about essentially having an online manual, complete with > instructions on how to install Rails, how to get started, and of > course guides to the different aspects of Rails. > > I'm not suggesting that we take a radically different direction; just > that some of the existing, high-quality content would benefit from > being edited into a coherent manual, that can be read from start to > finish. > > Furthermore, the reference documentation (rdoc) would benefit from > having links to the relevant chapters of such a manual. > > > Cheers, > Daniel > > On Oct 30, 1:01 pm, "Michael Koziarski" <[EMAIL PROTECTED]> wrote: >> On Thu, Oct 30, 2008 at 12:52 PM, Daniel Schierbeck >> >> >> >> <[EMAIL PROTECTED]> wrote: >> >> > Hi everybody >> >> > The recent surge in documentation effort, spurred mainly by the Rails >> > Guides project, has caused the quality of Rails documentation to >> > improve greatly -- at least that's my humble opinion. >> >> > There still is a big hole in the online docs for Rails, though -- a >> > real, official, in-depth manual, akin to the ones offered by PHP and >> > Django. >> >> > The guides provide a great foundation for such a manual, essentially >> > being a chapter each (although editing and streamlining would be >> > necessary.) >> >> > Is there a strategy on this area? Should there be? >> >> The guides as a whole are indeed intended to be the 'in depth' >> introduction and tutorial for their areas of rails. With the rdoc >> providing the detailed per class/method documentation. These two >> needs are completely different and I think the improvement in both >> these areas is enormous. They'll both, hopefully, continue to improve >> as we go along. >> >> What, beyond guides and rdoc, would a central manual be? >> >> Both the guides and the rdoc live alongside the source, and are >> maintained by the docrails guys: >> >> http://github.com/lifo/docrails/tree/master >> >> Any suggestions for improvements or editing should be handled through >> those channels. >> >> -- >> Cheers >> >> Koz > > > -- http://jeremymcanally.com/ http://entp.com/ http://omgbloglol.com My books: http://manning.com/mcanally/ http://humblelittlerubybook.com/ (FREE!) --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
