On 06/06/07, Philip Olson <[EMAIL PROTECTED]> wrote:
<snip>
The removed text in those PDO docs did not follow the guidelines so it was a bug.
What guidelines? There are guidelines in the PHP Documentation HOWTO for documenting user space interfaces. I haven't found any guidelines for what appears in the Appendices in the PHP Manual (which are a completely different kind of documentation). Please point out where these guidelines exist -- I can't accept your justification, otherwise. In many projects, the equivalent of what appears in the PHP Manual Appendices gets broken out into separate documents - and these separate documents get separate author (and other role) credits. Perhaps in your role as the PHP Manual editor, you could lead the php-doc community to revisit the decision to aggregate all PHP-related documentation together into a single package. And create guidelines for the documentation other than the user-facing syntax, functions, and methods. -- Dan Scott Laurentian University
