Keith, Question: Is the AOO documentation effort committed to publishing primarily on the wiki? Why not just produce ODT and PDF and make them available for download from the wiki? That's what we did for OOo back in the day. (At one point I did convert all the ODT files to wiki format, but that was a secondary effort.)
I think that expecting or requiring volunteers to deal with a wiki as well as becoming familiar with AOO itself is asking too much. If you want to publish on a wiki, I think you really need at least one person dedicated to converting Writer files to wiki format. IMX, DocBook is MUCH too difficult for most volunteers, though I understand there are reasonable front-ends available; I may be out of date. However, I think it's still asking too much of a volunteer to deal with more than one format. Producing the docs using Writer also provides an easy way to review and edit them, using change tracking. Attracting, mentoring, and keeping volunteers (with the necessary skills) is the biggest problem, and it won't be solved by technology. BTW, I am not available to mentor or otherwise assist, because I am already overcommitted to another project. Jean On Fri, Jul 3, 2020 at 1:25 AM Keith N. McKenna <keith.mcke...@comcast.net> wrote: > > This is a reminder that I am looking for input from this list as how to > best move forward on re-invigorating the Documentation effort for AOO > again the proposal document is attached to this e-mail. Thank you in > advance for your cooperation. > > Regards > Keith > > On 6/13/2020 9:40 PM, Keith N. McKenna wrote: > > It has been pointed out to me that I neglected to attach the document in > > the original post. It is now an attachment to this post. > > > > On 6/13/2020 4:52 PM, Keith N. McKenna wrote: > >> Greetings all; > >> > >> As the subject states I am proposing a new methodology to try to > >> reinvigorate the stalled documentation effort for AOO. For the first > >> step in this I have created a draft document that lays out the problems > >> and also some proposed solutions. As all most of you have been involved > >> in the documentation effort I would appreciate your comments and > >> suggested changes to it. The document was created in Writer and has > >> record and read changes turned on. Feel free to make any changes or > >> additions you feel could be helpful. Of course comments or suggestions > >> are welcome as replies to the to this mailing list as well. > >> > >> Thank you all in advance for taking time to contribute to this effort > >> and I hope many of you will return to the documentation team as we move > >> forward with this. > >> > >> Regards > >> Keith N. McKenna > >> > >> > > > --------------------------------------------------------------------- To unsubscribe, e-mail: doc-unsubscr...@openoffice.apache.org For additional commands, e-mail: doc-h...@openoffice.apache.org
