Re: [DOCS] Using DITA vs. Docbook for documentation?

[Jessica Tomechak <je...@gmail.com>]

-----Original Message-----

> From: Gavin Lee [mailto:gavin.lxh@gmail.com]
> Sent: Wednesday, September 26, 2012 6:25 PM
> To: cloudstack-dev@incubator.apache.org
> Subject: Re: [DOCS] Using DITA vs. Docbook for documentation?
>
> +1 for Docbook + Publican.
> imho, it's not the right time to switch the tool even DITA is better:
> a) Docbook can do almost everything we need at this moment, the html
> output is pretty good.
> b) Still need to hurry up on docbook, change to DITA may cost even more
> time to hit the release
> c) L10N part is easy to contribute on transifex based on po files
> generated by publican, not sure DITA
>
> If DITA is still better, think about using it in next major release(may be
> not 4.1).
>
>
> On Thu, Sep 27, 2012 at 5:18 AM, David Nalley <da...@gnsa.us> wrote:
> >> I don't have a real opinion on which format is really 'the best', but
> >> I do agree that we still have enough work to do with DocBook.
> >>
> >> Currently DocBook seems to do everything we need, so I don't see a
> >> real need for switching.
> >
> > I personally have opinions - but mainly around we have a group of
> > folks who are comfortable with DocBook and don't know about DITA. Why
> > fix what isn't broken?
> >
> > I do echo Wido's point - we have plenty of work to still do with our
> > existing documentation, and shifting our time to change format and
> > make everyone learn something new for what is arguably little or no
> > additional benefit seems like bikeshedding at best.
> >
> > --David
>


> --
> Gavin
>

Everyone here is stating the excellent reasons for staying with Docbook so
well. I have no quarrel with the sentiment expressed. Certainly, for the
foreseeable future, I don't see any compelling case for switching to DITA.
Thanks for weighing in.

Jessica T.
CloudStack Tech Pubs