On 5/31/2020 10:41 PM, Peter Kovacs wrote: > > Am 31.05.20 um 02:41 schrieb Keith N. McKenna: > >> 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. > > The SUSE documenters use(d) Docbook to create multiple targets for > documentation.
I like the idea of DocBook and since AOO will create the version 4.1.2 DTD for the XML structure the learning curve for a volunteer is greatly reduced. The learning curve would be myself and hopefully others in learning how to generate the different formats for distribution. > > They presented their way on FOSDEM in 2017, for LO. It was very > interesting. But I dont know if they stick to it, because LO shifted all > documentation into the web. > > And created a Platform similar to pootle. (I never looked at it, just > what I picked up from my FOSDEM visits) From What I can see from a cursory inspection of there documentation pages they have taken over the old ODF Authors site At least that is where the link in the old documentation from ODF Authors redirects to. > >> >> I look forward to any other suggestions that could move this effort >> along as it has languished for far to long. > > IMHO the first step is to create a plan. Dividing the plan into work > packages that can be promoted is important. > > Because all people who expressed interest expected they are told what > needs to be done where. They did not felt > > comfortable to figure that out on their own. Unfortunately that is not going to change a whole lot. Just as the development effort is self directed so is the Documentation effort and all volunteers are advised of that. One the the ultimate goals I have in mind is to re-invigorate doc@ as the place for all things related to documentation to help create the the community that will be necessary.. > > Also socializing seems to be important. The volunteers do not want to > work "alone". They want to be part of something. > > How it is done, did not seem so important to me on first spot. > > > I just want to point out, since I had multiple discussions now. ProOOBox > (Jörg care to share some details?) is working on a documentation update. > > Integrating them would be very nice from my stand point. Yes it would be, but could take a large translation effort if the Documentation they produce is not currently in English > > > That is my experience from Recruiting and AOO ComDev efforts I have been > involved in. > > > HTH > > Peter
signature.asc
Description: OpenPGP digital signature
