Re: Proposal to document all of Zend and PHP API and SAPI layers
| From: | Johannes Schlüter | Date: | Fri, 05 Apr 2013 12:23:24 +0000 |
| Subject: | Re: Proposal to document all of Zend and PHP API and SAPI layers | ||
| References: | 1 2 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-66978@lists.php.net to get a copy of this message | ||
On Fri, 2013-04-05 at 14:09 +0200, Ferenc Kovacs wrote:
>
> I think that it everybody would support that idea, unfortunatelly not
> many
> people have the knowledge AND the time to write up that kind of
> documentation.
That is the key part. There's no worse documentation than wrong
documentation. Maybe correct documentation only mentioning "useless"
information.
I also think that documenting each and every API leads nowhere, but as
Ferenc said we have to document the structure and help people tofind
what they need.
This all takes time, though, and many seem to prefer adding syntax sugar
and such things over fixing bugs and documenting things.
johannes