trafodion-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gunnar Tapper <tapper.gun...@gmail.com>
Subject Re: [DISCUSS] Apache OpenOffice instead of AsciiDoctor
Date Fri, 15 Jul 2016 18:11:56 GMT
A lot of copy/paste. :)

Might be able to import the PDFs into OpenOffice, too.



On Fri, Jul 15, 2016 at 10:52 AM, Atanu Mishra <atanumishra@gmail.com>
wrote:

> Hi Gunnar,
>
> All for making things simpler. Which this should.
>
> I assume this means moving away from the asciidoc format. Will there be a
> (big) migration effort?
>
> Thanks,
> Atanu
>
> -----Original Message-----
> From: Gunnar Tapper [mailto:tapper.gunnar@gmail.com]
> Sent: Friday, July 15, 2016 9:41 AM
> To: dev@trafodion.incubator.apache.org
> Subject: [DISCUSS] Apache OpenOffice instead of AsciiDoctor
>
> Hi,
>
> As you may have seen and/or experienced, it's not easy to work on our
> documentation since you have to setup the build environment, run maven
> builds, etc. And don't get me started on how clumsy it is to update
> documentation.
>
> I propose that we rethink the whole Asciidoctor approach and move to Apache
> OpenOffice instead, which is, of course, open source with a real word
> processor. IMO, the use of Asciidoctor creates a huge barrier to
> documentation creation. It is very, very cumbersome.
>
> In this model, we'd check in the OpenOffice source into the source tree.
> The publication would be a little more manual in that you'd have to
> generate the web pages and PDF files from within OpenOffice but I think
> that's an OK tradeoff. And, we can probably figure out a way to script such
> actions down the line.
>
> Thoughts?
>
> --
> Thanks,
>
> Gunnar
> *If you think you can you can, if you think you can't you're right.*
>
>


-- 
Thanks,

Gunnar
*If you think you can you can, if you think you can't you're right.*

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