On 10/2/06, Clinton Begin <[EMAIL PROTECTED]> 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.
