RE: [PHP-DEV] "waldschrotts guide to nifty references" - manualpagedraft, version 0.9b
| From: | Mike Robinson | Date: | Sun, 20 Aug 2000 02:47:58 +0000 |
| Subject: | RE: [PHP-DEV] "waldschrotts guide to nifty references" - manualpagedraft, version 0.9b | ||
| References: | 1 | Groups: | php.dev |
| Request: | Send a blank email to php-dev+get-29760@lists.php.net to get a copy of this message | ||
Ron Chmara wrote:
> I have not seen a *single* annotation yet which complains about having too
> much documentation, or too many answers. Just too many unanswered
> questions.
Bingo.
> > Manual takes 5-10 minutes to compile even now,
>
> Okay, I don't see the issue here.
Me neither.
Who cares if it takes 10 minutes or 30 minutes.
Its not like we have to go out in the yard and do it with
a shovel. The machine is doing it.
Another non-issue is the manual size.
Not long ago it was 600 pages. Now its a thousand.
In 6 months it'll be 1300.
So what if tutorials added more. If they're integrated into
the manual in a structured way, they can't help but benefit the
users. Thats good for them, good for php, and guaranteed a load off the
annotation and bug systems.
.mike