eMerzh, If you want to help the symfony project, enhancing the API is probably the easiest thing to do. You can create a ticket, and submit a patch with your enhancements.
Thanks, Fabien eMerzh wrote: > I Totally agree.. for me the lack of a clear and complete api is the > biggest pbm of Sf... > > i have another example : > here > http://www.symfony-project.org/api/1_2/sfTestFunctionalBase#method_checkresponseelement > you can find the documentation about checkResponseElement , and his > "option" parameter... > But what could i set in this options? I'm forced to look at the code or > so... > > If there is a technical platform for it wiki or something, i would be > glad to help the symfony team to write, translate or add examples in the > documentation.... > > > On Thu, Sep 24, 2009 at 04:16, zeek <z...@thesecondroad.org > <mailto:z...@thesecondroad.org>> wrote: > > > > > On Sep 23, 8:10 am, fakingfantastic <lakatos.fr...@gmail.com > <mailto:lakatos.fr...@gmail.com>> wrote: > > I recently had a discussion with Fabien about this topic, and he > > suggested it would be best if I stage the debate here. > > > > Has anyone ever felt like the information they needed to get on > > Symfony was hard to find? Do you find that the information you > need is > > very-well documented on the site, but it takes a while to search for? > > These are very big issues for me that over the last 6 months of me > > learning the framework, have made it quite difficult. > > The information is not optimized for fast lookup. It is optimized for > a beginner who has the time to spend a few weeks working through > tutorials. For someone with the time to read all the way through the > tutorials, the amount of information is terrific. But there is nothing > like www.php.net <http://www.php.net>. Often, I need to double check > the parameters for a > PHP function such as date(). So I open a new browser window and I > type: > > www.php.net/date <http://www.php.net/date> > > I would love something like that for Symfony. > > And examples are needed. That is something that www.php.net > <http://www.php.net> has. The > Symfony API is here, but there are no examples: > > http://www.symfony-project.org/api/1_2/ > > How does find one's way into a deep object hierarchy? If you just > click on an object in the API, you get data, but it is gibberish > unless you know how each piece connects to another. For instance, how > much do you learn here: > > http://www.symfony-project.org/api/1_2/sfFactoryConfigHandler > > A clickable UML map might be useful. While PHP is oriented toward > functions and methods, Symfony is fundamentally OOP, so an UML map > might be more useful that the long lists of functions that one finds > on www.php.net <http://www.php.net>. > > > > > > > > > > > > > > --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---