RE: [PHP-DEV] CVS Account Request: hitcho
I requested a status of my request last night on the list but without reply, can anyone give me assistance with this matter? Thank you!! Timothy Hitchens (HiTCHO) Open Platform Consulting e-mail: [EMAIL PROTECTED] -Original Message- From: Georg Richter [mailto:[EMAIL PROTECTED]] Sent: Wednesday, 1 January 2003 7:00 AM To: Philip Olson; Timothy Hitchens Cc: [EMAIL PROTECTED] Subject: Re: [PHP-DEV] CVS Account Request: hitcho 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. Georg -- PHP Development Mailing List http://www.php.net/ To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DEV] CVS Account Request: hitcho
On 31 Dec 2002, Timothy Hitchens wrote: Docs: 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. 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% :) See also: google.com Regards, Philip -- PHP Development Mailing List http://www.php.net/ To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DEV] CVS Account Request: hitcho
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. Georg -- PHP Development Mailing List http://www.php.net/ To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DEV] CVS Account Request: hitcho
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 -- PHP Development Mailing List http://www.php.net/ To unsubscribe, visit: http://www.php.net/unsub.php
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
Re: [PHP-DEV] CVS Account Request: hitcho
My take on all of this is that with examples we can direct people from the general help lists to these pages or simple copy and paste in as the reply to their question. Timothy Hitchens (HiTCHO) [EMAIL PROTECTED] HiTCHO | Open Platform Web Development Consutling - Outsourcing - Training - Support - Original Message - From: Georg Richter [EMAIL PROTECTED] To: Philip Olson [EMAIL PROTECTED]; Timothy Hitchens [EMAIL PROTECTED] Cc: [EMAIL PROTECTED] Sent: Wednesday, January 01, 2003 6:59 AM Subject: Re: [PHP-DEV] CVS Account Request: hitcho 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. Georg -- 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
Re: [PHP-DEV] CVS Account Request: hitcho
On Tuesday 31 December 2002 23:51, Timothy Hitchens \(HiTCHO\) wrote: My take on all of this is that with examples we can direct people from the general help lists to these pages or simple copy and paste in as the reply to their question. From the doc-meeting-protocol (phpdoc/RFC/protocol_20020310) 17. Examples The examples in the manual should be more consistent and useful. A draft styleguide alredy exists under phpdoc/RFC/coding_standards. Additional ideas that came up were syntax highlighting and linking functions in examples to their manual pages, which need either post-processing of the HTML output or the ext/xslt changes already discussed. We also talked about having a similar feature as the old pre-Windows Borland IDEs where it was possible to copy working examples to the clipboard with a special single keystroke. Possible ways to implement this for plain HTML and for CHM have to be examined ... Having an example index and additional code-only pages for examples might be an alternative to this. Happy new Year! Georg -- PHP Development Mailing List http://www.php.net/ To unsubscribe, visit: http://www.php.net/unsub.php
RE: [PHP-DEV] CVS Account Request: hitcho
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
Re: [PHP-DEV] CVS Account Request: hitcho
On 31 Dec 2002, Timothy Hitchens wrote: Modules: Output Buffering further development to enable more template environment advancement and error handling. THis module is very delicate and quite complex, it would not be advisable to dive into this and patch without consulting on php-dev. Perhaps karma for this should wait a little bit. Derick -- - Derick Rethans http://derickrethans.nl/ PHP Magazine - PHP Magazine for Professionals http://php-mag.net/ - -- PHP Development Mailing List http://www.php.net/ To unsubscribe, visit: http://www.php.net/unsub.php
