Re: Requirements for Documentation System

From: Date: Mon, 12 Apr 2004 21:30:21 +0000
Subject: Re: Requirements for Documentation System
References: 1 2 3 4 5  Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-3281@lists.php.net to get a copy of this message
On Apr 12, 2004, at 4:23 PM, David Costa wrote:
On Apr 12, 2004, at 11:02 PM, Paul M Jones wrote:
On Apr 12, 2004, at 3:34 PM, Jesus M. Castagnetto wrote:
XML supoorts international alphabete w/o much problem,. That's why we have a Russiand and an English version of the manual written in the same format (about 31 translations IIRC).
A nominal 6, not 31: English, French, Japanese, Hungarian, Dutch, Russian.
he referred to the php.net manual
My bad. We are talking about the PEAR manual, not the PHP manual.
yes, so why the PHP manual is up to date with mostly of the functions and the PEAR manual is not ? Given that the PHP manual is using DocBook... Following your logic with such an hard system the php main documentation should be desert too ;)
Fair enough -- it might have to do with the fact that there are orders-of-magnitude more people interested in PHP than in PEAR. 1% of a a hundred thousand contributors is a hundred times more than 1% of a thousand; they have a critical mass, and PEAR does not. Thus, we must make a critical mass by lowering barriers to entry. Thus, the "ease of use" requirement.
Here is my proposal. Let's draft a list of Undocumented packages. I will email each of the lead offering help if needed with the current technology. Let's see how it works then of course we can continue the discussion on alternatives, new technologies, miracles makers et al :D
Good idea, let's start it on a parallel thread and not re-purpose this one. Before you get going, you may want to make a list of the individual steps needed to go from "zero" to "competent" under the current system. I would be interested to see how many steps there are; I'm betting the process is non-trivial. ;-) -- Paul M. Jones Savant: the simple alternative to Smarty. http://phpsavant.com/

« previous php.pear.doc (#3281) next »