Re: "waldschrotts guide to nifty references" - manualpage draft, version 0.9b
| From: | Stanislav Malyshev | 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