List Info

Thread: Re: hosting packages on external VCS sites




Re: hosting packages on external VCS sites
user name
2007-03-21 04:57:16
On 3/21/07, Mika Tuupola <tuupolaappelsiini.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.

-- 
  mit freundlichen Grüßen
  Markus Tacker

  kontaktdaten ~ http://m.tacker.org/kont
akt/
Re: hosting packages on external VCS sites
user name
2007-03-27 20:52:12
Markus Tacker wrote:
> On 3/21/07, Mika Tuupola <tuupolaappelsiini.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

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


[1-2]

about | contact  Other archives ( Real Estate discussion Medical topics )