PEAR Documentation

[email protected] (Sean Coates)
Newsgroups php.evangelism
Message-ID <[email protected]>
Regarding PHP Evangelism, I think there's a LOT of work to be done with 
PEAR, especially concerning documentation. (yes, I know there are PEAR 
lists, but this directly relates to evangelism).

There was a recent thread on a message-board I frequent, discussing PEAR, 
and coding standards. (link: 
http://www.sitepointforums.com/showthread.php?s=&threadid=50331). Here's an 
excerpt that really got my attention:
--
(1 -Skunk)
PEAR is developing into a superb resource and it's a great shame more PHP 
coders aren't aware of it - this is mainly thanks to the PEAR site being 
pretty rubbish (there's lots of information on PEAR but very little of it 
is available to the public via pear.php.net)
(2 -Skunk (again))
PEAR's greatest weakness in my opinion is pear.php.net - the documentation 
there is fine but it is very limited and gives a bad representation of what 
PEAR is. The fact that Renegade is hung up on the coding standard is a 
direct result of the PEAR website not being clear enough - instead of the 
coding standard being hidden away in an apendix somewhere where only PEAR 
developers will read it it is sat on the main website giving off the 
impression that it is the most important thing about PEAR.
--

That pretty much sums it up, but to throw in my $0.02, I agree with Skunk. 
The PEAR site is great for developers who want to actually WORK on PEAR, 
but not so much for people who want to USE PEAR.

Does anyone know of a more extensive PEAR documentation project? I know the 
site is "Beta" (hence the background), but, IMHO, it doesn't do the library 
justice.

Opinions?

S
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.