I think some core emelents of symfony are still under heavy development and are not quite ready, so it doesn't make sense to start to change the docs. But i'm sure, if all features are clear and nothing new will be added, the devs will spend a lot of time again to make a perfect documentation with all the new features. So be patient ... ;o)
Michael On Feb 12, 9:42 am, Christian Schaefer <[EMAIL PROTECTED]> wrote: > hi all, > > I have been working with the Symfony trunk now for quite some time and > I have to say that most of the changes I became aware of are simply > astonishing! > > That been said the opposite is true for the documentation. I know this > is a development version and lack of documentation has to be expected > but the existence of a dev and 1.1 version of the Symfony book are > totally misleading. > > I don't mean to rant. I just wonder if there's a reason why new > completed features are not documented along the way? So far I gained > the impression that documentation is postponed to "whenever we get > round to it" and this fears me because the documentation so far is one > of the reasons so many people have rightfully turned towards Symfony. > > I also fear that postponing the documentation will lead to forgetting > about details. Wouldn't it be far easier to write the documentation of > a feature while or right after programming it? > Luckily some features such as the new form handling get explored > publicly on private blogs. Wouldn't it be wise to at least collect > those blogs and dedicate a page to them as a temporary documentation? > > And the current 1.1 and dev documentation pages should be removed as > long they are just copies of the 1.0 documentation? > > Just my two cents. Nevertheless you guys do some incredibly awesome > work on this! > > cheers > /christian --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "symfony developers" 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/symfony-devs?hl=en -~----------~----~----~----~------~----~------~--~---
