Re: Re: hosting packages on external VCS sites

From: Date: Sat, 24 Mar 2007 14:11:53 +0000
Subject: Re: Re: hosting packages on external VCS sites
References: 1 2 3 4  Groups: php.pear.dev 
Request: Send a blank email to pear-dev+get-46017@lists.php.net to get a copy of this message
Sebastian Nohn wrote:
Mika Tuupola wrote:
Bigger problem is documentation. Writing Docbook is quite painful. Debugging Docbook is painful. Installing own Docbook building environment is painful.
You are right with the wrtiung & debugging issues, but installation is no Problem here, neither with Cygwin nor with Ubuntu. All precompiled binaries.
I have long shared Mika's concerns, but have started to feel differently lately: Quite a few times when people reported about installation issues on the documentation mailing list (or elsewhere), I offered my help. In some cases we exchanged a few mails off-list and were able to resolve the issue with relatively little pain. But, and that's what irritates me, in most cases I received zero replies after offering my help. This either means that people are too lazy to invest a bit of time, or that they were able to solve their problem on their own with a little bit of poking around. Nonetheless I think that we should eventually also support reStructuredText as an alternative to DocBook. - Martin

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