Greetings Detlaf; See comments in-line On 7/10/2020 7:00 AM, Detlef Nannen wrote: > Hi, > > so far I only have experience with documentation written in AOO itself. > I've been experimenting with Markdown and Pandoc from time to time, and > wasn't always happy with the results and the possibilities. An amount of > time that I was not willing to give. And even now I don't have the time > to go deeper into it. The maximum what I can do beside my other tasks is > to cooperate in the creation of the documentation.
If that is all you can do that is no problem.That is what the Apache Way is about in part; contributing your time and talents when and where you can. > > Since this is supposed to be about the documentation, I consider the > tool for this to be of secondary importance. We have AOO. We can write > the documentation with it or update existing documentation with it. > My original intention was to use AOO to write the documentation and then use something along the lines of DocBook or Pandoc to create different delivery formats. Updating existing documentation is problematic as any of OOo Authors documentation is dual licensed under the GNU General Public License Version 3 or later, or the Creative Commons Attribution License Version 3 or later. Since they would not be part of a formal AOO release I believe we could continue to distribute both ODT and PDF formats from the mwiki but I would feel more comfortable running it by legal discuss. he other alternative would be continue trying to get the current mwiki documentation written or updated. > There's certainly nothing to be said against converting the results into > another format later using Docbook (which I only looked some Minutes at) > or Pandoc. > > However, I'm thinking about the people who want to work on the > documentation. I don't have any experience here, so I don't know how > many people want to or can work on it. Is there a plan? Maybe there are > some who read this and ask themselves the same questions. Apart from the > tools, this seems to me to be an important topic. Has it perhaps been > discussed before? I haven't found anything current on the AOO website. > For a task like documentation I think an organization is necessary. > Wouldn't it be fatal if, for example, three different people were to > write about a topic without knowing about each other? One person uses > AOO with templates, another person writes in a simple text editor. > It was never the intention to have the average volunteer use the conversion tools, but a small group of people that were interested in learning to use them to create the alternative sources. ODF and PDF files can be created direct from AOO. Things like the mwiki format or EPUB cannot. Regards Keith
signature.asc
Description: OpenPGP digital signature
