Re: hosting packages on external VCS sites

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/)

-- 
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub
.php

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.

-- 
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub
.php