Pete Sergeant writes:
> Specifically, the PHP documentation rules. They have an online
> manual to which people can add notes, and the manual has thus
> evolved into something like a cookbook, passed down from
> generation to generation (perhaps I'm just being romantic). I
> think that's excellent. What else have people found excellent
> about other forms of docs that Perl lacks?
The PHP documentation sucks. Their annotation system has taken the
place of actual updates to the documentation. Some shitty
explanations in the documentation persist, despite being contradicted,
confused, or amplified by the annotations.
Annotation does not replace editing.
(I know this because I'm editing a book on PHP :-)
Nat
