incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gunnar Tapper <tapper.gun...@gmail.com>
Subject [DISCUSS] Documentation
Date Fri, 11 Nov 2016 07:46:04 GMT
Hi,

Related to the muti-lingual issue but also separate since it has to do with
tools. This might be the wrong list to so please feel free to redirect.

I've created a lot of documentation for Trafodion using Asciidoc, which
allows the project to include the documentation with the source. It's OK
but also complicated when wanting to provide PDF versions of the manuals
due to font issues and other things.

Talking with other contributors, there's a clear preference to use Apache
OpenOffice for documentation. Beyond usability (and therefore more
willingness to document), it also makes translation easier.

Has anyone used OpenOffice for documentation before? If so, how is it
handled with source control etc? (OpenOffice files are really zip archives
with multiple files in them.)

Thoughts?

-- 
Thanks,

Gunnar

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message