Bertrand Delacretaz wrote on 11/11/16 9:37 AM: > On Fri, Nov 11, 2016 at 8:46 AM, Gunnar Tapper <tapper.gun...@gmail.com> > wrote: >> ...Talking with other contributors, there's a clear preference to use Apache >> OpenOffice for documentation.... > > *for some people*, right? I think many of us are big fans of creating > documentation using structured text in version control repositories.
Yes, using AOO is very hard on version control, since it's normally stored as a blob not a diff. There are many different structured documentation tools in various projects at Apache, and both PDFBox, Cocoon, and Forrest (and probably others) can be used to translate various kinds of structured docs (asciitext, markdown, xml, whatever) into PDFs for reading if desired. >From the peanut gallery, I'd suggest researching some of the other doc tools in use at Apache projects - perhaps ask on d...@community.apache.org as well for ideas. But in the end, the decision is up to whoever's actually writing the docs *for that project*. If your contributors really will prefer AOO over other tools, then use that. - Shane --------------------------------------------------------------------- To unsubscribe, e-mail: general-unsubscr...@incubator.apache.org For additional commands, e-mail: general-h...@incubator.apache.org
