Hi. Recently, in one post, I note someone mentioned the prospect of different guides for different OS. This is important because having a guide with various screen captures and instructions for mac doesn't necessarily work with GNU Linux features.
The past documentation was a mix of Windows/Mac and GNU Linux captures and not always relevant. Additionally, I have not reviewed the entirety of this self published guide - and great if Jean wants to work on that - however, when I was volunteering with Libre, I noted the GSG was 700 pages or so. If the scope of that guide is this complete, that is a resource. The effort here for GNU Linux I am putting in - is to create clear and concise - current info relevant to GNU Linux users. As a technical writer of GNU Linux documentation for over 20 years, I believe the guides I am creating will be useful. In fact, I created an installation guide and was contacted by a user who informed me this would have been useful years ago when he tried to install. I just hope my effort here will be useful to the audience. ----- Original Message ----- From: "F Campos Costero" <fjcc.apa...@gmail.com> To: doc@openoffice.apache.org Cc: "Keith N. McKenna" <keith.mcke...@comcast.net> Sent: Saturday, January 23, 2021 8:06:05 PM Subject: Re: Proposed Process for Documentation I agree that there is no significant conflict here. The only outstanding question is where to host the documents. Settling that should not inhibit anyone from working on documents. One feature of the Apache governance method is that volunteers decide what will get done and how it will be done. The question of document hosting can be decided by the interested parties. The PMC should know what will be done, in case it is obviously unacceptable, but making a decision and taking action is largely up to the few people in this discussion. I will find Jean's message about her Getting Started Guide and ask for more details about what she is considering. Francis On Sat, Jan 23, 2021 at 7:04 PM Dennis Hamilton <orc...@msn.com> wrote: > -----Original Message----- > From: Keith N. McKenna <keith.mcke...@comcast.net> > Sent: Saturday, January 23, 2021 15:43 > To: doc@openoffice.apache.org > Subject: Re: Proposed Process for Documentation > > [orcmid] [ ... ] > > As there are obviously still conflicting views on how documentation should > be handled. I have decided to step away from this entirely and concentrate > my volunteer efforts elsewhere. > > Regards > Keith > > [orcmid] > I don't think there are conflicting views. There have been considerations > of a few approaches and ways of satisfying ASF sensibilities. There are > some concerns about ASF sensibilities with regard to carrying > "foreign"-licensed materials in ASF repositories. > > For example, one option would be going the AOOAuthors route and hosting > that effort on GitHub. > > The alternative Keith favors involves hosting within the AOO project in a > manner that does not conflict with ASF sensibilities about licenses. As > far as I can tell, no one is stopping that being set up and contributors > recruited. > > One caveat. Jean Weber has offered to update her self-published "Getting > Started" book on AOO to be suitable for AOO 4.1 users (unless 4.2 is > imminent, I suppose). It would seem valuable to rely on that, including > assisting her, rather than have duplicate effort inside the AOO project. > So maybe there should be a different focus for the AOO effort, starting > with OO 3.2 User Guides. > > - Dennis > > --------------------------------------------------------------------- > To unsubscribe, e-mail: doc-unsubscr...@openoffice.apache.org > For additional commands, e-mail: doc-h...@openoffice.apache.org > --------------------------------------------------------------------- To unsubscribe, e-mail: doc-unsubscr...@openoffice.apache.org For additional commands, e-mail: doc-h...@openoffice.apache.org
