Re: hosting packages on external VCS sites
| From: | Stefan Neufeind, PEAR | Date: | Wed, 28 Mar 2007 01:52:12 +0000 |
| Subject: | 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-46075@lists.php.net to get a copy of this message | ||
Markus Tacker wrote:
> On 3/21/07, Mika Tuupola <tuupola@appelsiini.net> 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).
E.g. Typo3 uses pre-defined OpenOffice-templates and parses HTML
(including images, tables, ... - even chapter-structure) out of them.
But the technical details finally lead to a doc-centric discussion which
we might want to revive on pear-doc again imho.
Regards,
Stefan