ibatis-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Clinton Begin" <clinton.be...@gmail.com>
Subject Re: New iBATIS Documentation Format
Date Wed, 04 Oct 2006 02:39:25 GMT
I don't think Brandon was suggesting we continue to use OOo with DocBook.  I
can attest to the poor quality of the DocBook output from OOo....

But it's a good way to start.  We can export to DocBook, then clean it up (a
lot).  From that point on, we use XXE or a text editor...


On 10/3/06, Ted Husted <husted@apache.org> wrote:
> On 10/2/06, Clinton Begin <clinton.begin@gmail.com> wrote:
> > DocBook -- currently the choice of iBATIS.NET documentation.  It excels
> at
> > "diffability" and multi-format including great PDF and HTML output.  But
> it
> > fails at ease of use / familiarity and therefore participation and quick
> > changes/deployment as well.  All other criteria are met but not
> exceeded.
> DocBook with OpenOffice seems like a fair option.
> One thing to watch is whether systems like XMLMind format the
> underlying content in the same way. We'd want to avoid unnecessary
> cruft on the checkins, so if everyone is OK with OpenOffice, that
> might make for the best default editor.
> The OO XML format is not the friendliest for a change log, since it
> doesn't wrap lines, but it does seem like the lesser of evils.
> DocBook is also compatible with systems like Maven and Forrest, should
> that ever come up.
> -Ted.

View raw message