On 5/30/2020 8:46 PM, Dave Fisher wrote: > Keith, > > I pledge to support you however I can. > > I’ve been thinking about www.openoffice.org > > What do you think about using markdown? > > Regards, > Dave > > Sent from my iPhone
I appreciate the pledge of support Dave. I am leery of using markdown for the same reasons I expressed about Docbook; IE. the learning curve. I lean towards using AOO Writer as most people that volunteer are familiar with Writer and there are more people that can mentor people in the use of it. Another is is the use of templates to create a uniform look and feel, plus it reinforces the the brand image of AOO by using our own product to create professional looking documents. A potential use for markdown would be as another method of distributing the documentation by use of a converter to generate the markdown files for adding them to the Website but as we already have much of the documentation on the wiki this would need to be discussed further. Regards Keith > >> On May 30, 2020, at 5:42 PM, Keith N. McKenna <keith.mcke...@comcast.net> >> wrote: >> >> I should probably have my head examined but I am thinking of one more >> time trying to revive the documentation effort for AOO. One of the >> drawbacks is that most people that have started to help have left as >> there has been very limited availability of mentoring. I do not see this >> changing but I am hoping that by defining a new process we can reduce >> the dependency on mentoring. >> >> One idea for this would require that the MediaWiki extension be made >> functional again. This would allow for using Writer to create the source >> which could be stored in the git repository and then be transferred to >> the mwiki for easy online access. By storing the source in the >> repository it would give us better revision control over the >> documentation. Plus it may help relieve the mentoring problem as many >> more people are familiar with using Writer. >> >> Another would be to use Docbook, though this is not as appealing as I >> have no familiarity with it and it appears that there is a steep >> learning curve to its use and that would be a disadvantage to attracting >> new people. >> >> I look forward to any other suggestions that could move this effort >> along as it has languished for far to long. >> >> Regards >> Keith >>
signature.asc
Description: OpenPGP digital signature
