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 -~----------~----~----~----~------~----~------~--~---
