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