Re: hosting packages on external VCS sites

From: Date: Wed, 28 Mar 2007 05:19:20 +0000
Subject: Re: hosting packages on external VCS sites
References: 1 2 3 4 5 6  Groups: php.pear.dev 
Request: Send a blank email to pear-dev+get-46081@lists.php.net to get a copy of this message
Jon Parise wrote:
On Wed, Mar 28, 2007 at 03:52:12AM +0200, Stefan Neufeind, PEAR wrote:
My point is. To achieve great docs we must have easier way to write them.
I agree very much. It would be great to have a wiki. For most packages docbook is a huge overhead for a one-page documentation.
While I agree with you that Docbook is a "pain" somehow, please keep in mind that the original intention was to be able to easily transform documents to other formats. Guess that's not that easy to do with Wiki-style (or you lack flexibility).
This is an interesting requirement to revisit. What other formats are we interested in supporting (read: requiring)? Here's a possible complete list: 
    Plain text
    HTML (simple)
    HTML/PHP (complex)
    Compressed HTML (HTMLHelp / Windows Help)
    Manpages
    PDF
To really push it there could be latex. Arnaud.

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