Re: hosting packages on external VCS sites
| From: | Jon Parise | Date: | Wed, 28 Mar 2007 05:07:39 +0000 |
| Subject: | Re: hosting packages on external VCS sites | ||
| References: | 1 2 3 4 5 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-46079@lists.php.net to get a copy of this message | ||
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
--
Jon Parise (jon of php.net) :: The PHP Project (http://www.php.net/)