Re: "waldschrotts guide to nifty references" - manualpage draft, version 0.9b

From: Date: Sat, 19 Aug 2000 22:59:42 +0000
Subject: Re: "waldschrotts guide to nifty references" - manualpage draft, version 0.9b
References: 1  Groups: php.dev 
Request: Send a blank email to php-dev+get-29738@lists.php.net to get a copy of this message
RL>> There is nothing De-facto about it. The manual is not just a RL>> reference. It never was. None of this is reference: You writing "just a reference" as if you implied reference is bad or insufficient. In fact, reference manual is most important (and most useful) part of any documentation. Actually, having good reference manual is one of the strongest points of PHP. RL>> RL>> http://www.php.net/manual/features.php RL>> RL>> And it is most definitely a useful part of the manual. We need more of RL>> the same. Well, certainly not meaning to flame somebody's work, but of the topics there: "Error handling" is certainly reference "Creating and manipulating images" is a reference too (2 paragraphs hardly make a tutorial) "HTTP authentication with PHP" - reference "Cookies" - reference "Handling file uploads" - here goes something more like tutorial "Using remote files" - reference again "Connection handling" - reference "Persistent database connections" - reference/user's guide That's not to say these chapters are bad - on the contrary, they perfectly fit the manual. Maybe they need more text here and there (even a reference can have more than 2 paragraphs :) -- Stanislav Malyshev stas@zend.com +972-3-6139665 ext.106

« previous php.dev (#29738) next »