Re: Requirements for Documentation System
| From: | Paul M Jones | 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:
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.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 ;)On Apr 12, 2004, at 11:02 PM, Paul M Jones wrote:My bad. We are talking about the PEAR manual, not the PHP manual.On Apr 12, 2004, at 3:34 PM, Jesus M. Castagnetto wrote:he referred to the php.net manualXML 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.
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 :DGood 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/