Done http://trac.symfony-project.org/changeset/24275
Fabien -- Fabien Potencier Sensio CEO - symfony lead developer sensiolabs.com | symfony-project.org | fabien.potencier.org Tél: +33 1 40 99 80 80 Crafty_Shadow wrote: > Fabien Potencier wrote: >> Adding a comment at the top of the file with a link to the right section >> of the reference guide seems like a good idea. > > Yes, having 2-3 sentances describing the purpose of the particular > config file (for users new to symfony) plus a link to the reference > guide seems to be the best option. > +1 > > >>> 2009/11/22 Łukasz Wojciechowski <[email protected]>: >>>> I also noticed that they are gone and I also think that It would be >>>> better If we had them back. >>>> -- >>>> Best regards >>>> Łukasz Wojciechowski >>>> New Generation Software >>>> +48 602 214 629 >>>> http://www.ngsoft.pl >>>> 2009/11/22 ever.zet <[email protected]>: >>>>> Fully agree with Crafty_Shadow. Old comments style in settings.yml was >>>>> very helpful! >>>>> 22.11.2009, в 13:39, Crafty_Shadow написал(а): >>>>>> As of symfony 1.3, the configuration files no longer contain a >>>>>> reference to the possible configuration options in the form of >>>>>> commented out lines of the defaults and their explanation. I am well >>>>>> aware of the symfony reference book, however I strongly believe the >>>>>> old approach was better. >>>>>> For starters, with the old approach I didn't need to open a browser, >>>>>> find the book, search for that particular config file and finally find >>>>>> the option I need. This is very time-taking and frustrating compared >>>>>> to the work-flow with 1.2. What, are we supposed to remember every >>>>>> configuration option by heart now? >>>>>> And what about the people who just start with symfony, or are joining >>>>>> a project already in progress? How are they supposed to figure this >>>>>> out? Read the definitive guide, find the reference to the reference >>>>>> book (pun intended) and all that when all the info they needed >>>>>> could've been left in the very same configuration file? >>>>>> What was the reason for removing this information? It can't be to >>>>>> speed up the parsing as these files are cached anyways. >>>>>> -- >>>>>> 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 >>>>>> athttp://groups.google.com/group/symfony-devs?hl=. >>>>> -- >>>>> 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 >>>>> athttp://groups.google.com/group/symfony-devs?hl=. >>>> -- >>>> 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 >>>> athttp://groups.google.com/group/symfony-devs?hl=. >>> -- >>> 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 >>> athttp://groups.google.com/group/symfony-devs?hl=. >> > > -- > > 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=. > > > -- 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=.
