-----Original Message----- > From: Gavin Lee [mailto:gavin....@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
