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=.
