Re: [PEAR_PackageFileManager] UserGuide and Tutorial -call for comment

From: Date: Mon, 13 Nov 2006 17:41:08 +0000
Subject: Re: [PEAR_PackageFileManager] UserGuide and Tutorial -call for comment
References: 1 2 3  Groups: php.pear.dev 
Request: Send a blank email to pear-dev+get-44930@lists.php.net to get a copy of this message
Laurent Laville wrote: > For many reasons, as I've already explained in past when I wrote other > manuals (in docbook format), this one will be again a standalone > version. No pear doc integration. > > Main reason : I used all dockbook tags I want without restriction and > some features that are probably not supported by pear manual architecture. > > But as, like other manuals I've wrote for HTML_CSS, HTML_Progress2, ... > an html copy will be available with next stable release. > > LAST: I plan to publish the stable release 1.6.0 with a full user guide > for November 21st. > > If someone is not agree or want to see something else in this manual, > you have again 9 days. Hi Laurent, I can't support this decision. There are hundreds of grammar errors in the documentation you've written, and more than one factual error. I don't see any good reason to avoid the PEAR manual. The thing is already in docbook! It wouldn't take long to tweak it to fix any compatibility issues encountered. Most important, it cannot be translated or edited by anyone else as long as it it outside of CVS. HOWEVER, I understand and appreciate the effort you've put into this, and if you choose to publish the manual as an independent HTML document, I won't stop you. I have, however, removed myself as a developer from PEAR_PackageFileManager (marking as inactive) as I don't agree with the majority of your recent decisions, and also don't have the time to do anything about it. I hope you can understand my feeling on this issue. Greg

« previous php.pear.dev (#44930) next »