Re: [symfony-devs] Component documentation

2011-11-28 Thread Lukas Kahwe Smith
On Nov 28, 2011, at 16:04 , Luis Cordova wrote: > Drak > > lsmith PR'ed sometime ago an initial docu on each component, have you > checked that? that was only basic README's. but Fabien seems to think in that state they hurt more than they help, though he hasnt told me what the exact issue is.

Re: [symfony-devs] Component documentation

2011-11-28 Thread Drak
Sure, but it's very limited - it's just a simple readme. I'm taking about a full and complete tutorials on the observer pattern, then practical uses of the EventDispatcher, as a standalone component - something that could be rendered automatically by Sphinx too. In order for these technologies to

Re: [symfony-devs] Component documentation

2011-11-28 Thread Luis Cordova
Drak lsmith PR'ed sometime ago an initial docu on each component, have you checked that? On Mon, Nov 28, 2011 at 10:02 AM, Drak wrote: > Hi, > I wonder if we can start a separate section in the documentation at Symfony2 > for documenting the individual Symfony2 components?  I would like to start

[symfony-devs] Component documentation

2011-11-28 Thread Drak
Hi, I wonder if we can start a separate section in the documentation at Symfony2 for documenting the individual Symfony2 components? I would like to start by writing documentation on the EventDispatcher not only to explain how it works, but to also talk about the whole concept of event notificati