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

From: Date: Sat, 19 Aug 2000 22:46:16 +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-29733@lists.php.net to get a copy of this message
RL>> What makes you think the online manual is only a reference manual? It Because it is like any of dozens of reference manuals I saw. If it goes like duck and quacks like duck, you know... At least now, it's clearly a reference manual. I don't know what was the intent, maybe it was the user's guide, but what came out is clearly like reference manual :) RL>> doesn't say "Reference Manual" anywhere. It says "PHP Manual". RL>> It RL>> includes a section called "Language Reference" and it includes another RL>> section called "Function Reference", but there is a reason that these are RL>> individual sections. If somebody wants to write some good tutorials RL>> explaining various concepts in PHP, then they will be added. Have a look RL>> through the things in the "Features" section of the manual. I don't think tutorials really should be there. Manual takes 5-10 minutes to compile even now, and adding tutorials here will make it unmaintainable. Why just not to make another book and call it PHP Tutorials or whatever? Why it must be one book that does all? I just imagined that all my Perl books suddently became one, and believe me, this is a frightening thought... We better don't do that. -- Stanislav Malyshev stas@zend.com +972-3-6139665 ext.106

« previous php.dev (#29733) next »