[PHP-DOC] RE: [PHP-DEV] "waldschrotts guide to nifty references" - manualpagedraft, version 0.9b From: Mike Robinson (mgrphp3 <email protected>)
Date: 08/19/00

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