Re: Requirements for Documentation System

From: 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

« previous php.pear.doc (#3596) next »