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



-- 
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php

Reply via email to