Perhaps we should try to get documentation for those functions which don't have anything before we worry about trying to go through and add more examples for those that do?
John >-----Original Message----- >From: Tularis [mailto:[EMAIL PROTECTED]] >Sent: Tuesday, December 31, 2002 5:20 PM >To: [EMAIL PROTECTED] >Subject: Re: [PHP-DEV] CVS Account Request: hitcho > > >Philip Olson wrote: >>>>>Setup a common thread of examples across all PHP >>>>>documentation as 80% of all questions about PHP on >>>>>lists could be answered with common examples across >>>>>all functions in the documentation. >> >> >> On Tue, 31 Dec 2002, Georg Richter wrote: >> >>>On Tuesday 31 December 2002 22:39, Philip Olson wrote: >>> >>> >>>>80% of all questions about PHP on the lists could be answered if >>>>people read the manual in the first place. Wait, make that 95% :) >>>> >>> >>>Philip, we need more examples (and also correct ones). Hitcho is >>>absolutely >>>right here. Were also discussed this during the last doc >meeting in march >>>2002. >> >> >> Are more useful examples needed? Yes. Can the manual be >> improved? Yes. Will new better examples in the manual >> solve 80% of all problems? No. Do I want people like >> Hitcho to work on the manual? Hell yeah! Are my comments >> meant to be rude? No. Should people read the manual? Yes. >> Do people who post to the lists currently read the manual? >> Mostly No. Should they? Yes. Should they also do searches >> with google/archives before asking? Yes. >> >> Regards, >> Philip >> >> >**first wants to point out it's easier to put a reply ABOVE the quoted >text** > >I have to admit I think you're right in a lot of points philip, he >should indeed be allowed to help with the phpdocs. Though, the results >of him adding more examples would result IMHO in the following >2 things: > >1 - Inexperienced ppl would be overwhelemed by the amount of examples, >and compex ways to 'use' something. Thus making their scripts more >complex than they need to be, and finally resulting back here in the >lists asking for help. >2 - Most (more) experienced ppl would benefit a bit from the >examples by >seeing how you 'could do it', but then again, more ppl would start >coding 'the same way', by that I mean to say that there are >more ways to >code something.... There *ALWAYS* are more ways. > >These things might seem a bit far off, but they are true IMHO. >Nevertheless, I would appreciate more documentation examples, and it >sure is something I will be adding in the next few days off I have ;) > >- Tularis > > >-- >PHP Development Mailing List <http://www.php.net/> >To unsubscribe, visit: http://www.php.net/unsub.php > > -- PHP Development Mailing List <http://www.php.net/> To unsubscribe, visit: http://www.php.net/unsub.php
