ibatis-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Larry Meadors" <lmead...@apache.org>
Subject Re: New iBATIS Documentation Format
Date Wed, 04 Oct 2006 02:50:20 GMT
I'd agree - OOo on my box is total crap for docbook - like worse than
Word for HTML.

Larry


On 10/3/06, Clinton Begin <clinton.begin@gmail.com> wrote:
> 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...
>
> Cheers,
> Clinton
>
>
> 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.
> >
>
>

Mime
View raw message