But seriously -- if you felt the PDO reference page was that bad all
this time, have you offered any suggestions in the past for how to
improve it?
Is it any wonder that people lose interest in contributing to a
project subject to so much criticism and so little positive feedback?
Because nobody feels compelled to speak out when everything is fine (or good enough)? You don't see people running around streets screaming "no fire! no fire!". :) When there is a fire, that's different.
As I see, right now the problem is not with PDO at all, but with the fact that every OO extension in phpdoc has its own documentation standard which is not described anywhere. PDO page might be a bit on the long side, but I think it's not anybody's fault but a consequence of having no "how we do big modules in docs" standard. I understand there's work going on about it, which is very welcome.
--
Stanislav Malyshev, Zend Software Architect
stas@zend.com http://www.zend.com/
(408)253-8829 MSN: stas@zend.com