Excerpts from Philip Olson's message of Thu Jun 04 19:00:19 -0400 2009: > Basically it comes down to the following options (please also think of > others): > A) Suggest the helper be a PEAR package (PEAR Manual) > B) Simply add examples of its use in the PHP manual > C) Determine DocBook syntax, and fully document it within the PHP > manual > > We basically follow the PEAR route, but I don't think all of these > extensions will have associated PEAR packages. So today we prefer and > suggest (A), allow (B), but disallow (C) ... does that sound right? > Please think about it and determine if (C) feels like a good idea.
I would agree with the current assessment. While I've always felt that the strength of the PHP documentation was the fact that it was a one-stop shop for all of your core PHP documentation needs, including documentation of PHP libraries (even if they're associated with PECL) is a slippery slope-- additionally, the PEAR documentation isn't exactly... good. Having a centralized repository of documentation would be nice, but it's unclear if we can make it happen. Cheers, Edward
