Re: Requirements for Documentation System
| From: | Jesus M. Castagnetto | Date: | Sat, 17 Apr 2004 12:35:32 +0000 |
| Subject: | Re: Requirements for Documentation System | ||
| References: | 1 | Groups: | php.pear.doc |
| Request: | Send a blank email to pear-doc+get-3596@lists.php.net to get a copy of this message | ||
--- Alan Knowles <alan@akbkhome.com> wrote:
> + Tool to convert existing work done in docbook into
> system X...
> * we have quite a large documentation base
> already in docbook
> (although some is little more than stubs created
> by phpdocu...)
>
> + Doc generation tools have large userbase, and are
> maintained...
> * So when someone looses interest in maintaining
> the system X => HTML
> Convertor we hare not left hanging..
>
> From what I have seen - the Wiki->docbook idea that
> paul has, seems
> vaugly workable.. - but I do suspect that like I
> found with
> OO<->docbook, it may have some serious flaws..
> (especially on round
> tripping..)
Same problem with reST -> DocBook, or LaTeX -> DocBook
(I've tried both at different times). I would tend to
think that going from OO to DocBook might be simpler
to improve. It will depend on how good are the XSLTs
to do the transformation.
Just my 2 cents.
=====
--- Jesus M. Castagnetto <jmcastagnetto@php.net>
__________________________________
Do you Yahoo!?
Yahoo! Tax Center - File online by April 15th
http://taxes.yahoo.com/filing.html