Re: Lack of docs: reality check

From: Date: Tue, 13 Apr 2004 09:25:07 +0000
Subject: Re: Lack of docs: reality check
References: 1  Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-3310@lists.php.net to get a copy of this message
On Apr 13, 2004, at 11:15 AM, Alexey Borzov wrote:
Greetings. To those who feel that PEAR lacks docs because of DocBook format: have you *ever* seen a developer posting a message along the lines of "I *wrote* these cool docs, available here, but am unable to convert them to this horrible DocBook"? Clarification: it is quite different from "we *will* write docs, honest, if it wasn't for DocBook". I totally agree with you. Never seen anything like that or some docs in .txt/html/pdf format with an email "please convert these for me..." :D
But I have seen new developers (like Richard on Mail_IMAP) genuinely interested in good docs being able to produce some documentation on their site with PHPDocumentor but having problems with Docbook. Still, (as Jesus pointed out) it is good thing® to have this discussion and I like Paul's bringing up the Docs issue. Cheers David
-- PEAR Documentation List Mailing List (http://pear.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php


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