It's not just code examples though, it's more the "gotchas" or misunderstandings that other people have had but can then comment on to say "actually, you might think this does x but it does y instead". The mod up / mod down is also a good idea so that bad examples can get buried or removed completely. The PHP docs have official "examples" directly in the API docs - I know there are plenty of examples in the symfony book but when you're after a specific usage of a particular function it's harder to wade through. Maybe the best examples in the comments can get "promoted" to the official API directly above them with enough votes?
The "Definitive Guide" / "Practical Symfony" should be the "how to write Symfony apps" docs and the API should be a quick reference - there's bound to be some overlap but that's not really a bad thing as long as it's consistent info. On Sep 28, 8:42 pm, Fabian Lange <fabian.la...@symfony-project.com> wrote: > Hi Bruno > > On Mon, Sep 28, 2009 at 4:32 PM, Bruno Reis <bruno.p.r...@gmail.com> wrote: > > For me, there is one major reason for the popularity and spread of the php > > in the word: comments on the manual pages! > > For me the popularity and spread of really bad and crappy code are the > comments on the manpages. so many people think it is actually good > code to copy, but frankly, i cannot remember a single god quality > piece of code. > > Similar bad code examples exist also for other languages (like the > stuff on kickjava) but nowhere they are promoted like in the php.net > manual. > If you are using code from php.net you are putting your applications at risk > > Yes I have an extreme position. > So I challenge you to show me a good code example from php.net that we > then can discuss. (preferrably on a different thread) > > Fabian --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "symfony users" group. To post to this group, send email to symfony-users@googlegroups.com To unsubscribe from this group, send email to symfony-users+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/symfony-users?hl=en -~----------~----~----~----~------~----~------~--~---
