Return-Path: X-Original-To: apmail-openoffice-doc-archive@minotaur.apache.org Delivered-To: apmail-openoffice-doc-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 11197EBD9 for ; Sun, 20 Jan 2013 20:21:41 +0000 (UTC) Received: (qmail 75174 invoked by uid 500); 20 Jan 2013 20:21:40 -0000 Delivered-To: apmail-openoffice-doc-archive@openoffice.apache.org Received: (qmail 75144 invoked by uid 500); 20 Jan 2013 20:21:40 -0000 Mailing-List: contact doc-help@openoffice.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: doc@openoffice.apache.org Delivered-To: mailing list doc@openoffice.apache.org Received: (qmail 75136 invoked by uid 99); 20 Jan 2013 20:21:40 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 20 Jan 2013 20:21:40 +0000 X-ASF-Spam-Status: No, hits=-0.0 required=5.0 tests=RCVD_IN_DNSWL_NONE,SPF_HELO_PASS,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.apache.org: domain of gcaod-doc@m.gmane.org designates 80.91.229.3 as permitted sender) Received: from [80.91.229.3] (HELO plane.gmane.org) (80.91.229.3) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 20 Jan 2013 20:21:32 +0000 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1Tx1OP-0000WN-Nu for doc@openoffice.apache.org; Sun, 20 Jan 2013 21:21:25 +0100 Received: from c-24-60-71-26.hsd1.ma.comcast.net ([24.60.71.26]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 20 Jan 2013 21:21:25 +0100 Received: from keith.mckenna by c-24-60-71-26.hsd1.ma.comcast.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 20 Jan 2013 21:21:25 +0100 X-Injected-Via-Gmane: http://gmane.org/ To: doc@openoffice.apache.org From: "Keith N. McKenna" Subject: Re: Starting to build the user guide [Was Re: Possible workflow] Date: Sun, 20 Jan 2013 15:20:49 -0500 Lines: 202 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: c-24-60-71-26.hsd1.ma.comcast.net User-Agent: Mozilla/5.0 (Windows NT 5.1; rv:17.0) Gecko/20130107 Thunderbird/17.0.2 In-Reply-To: X-Virus-Checked: Checked by ClamAV on apache.org RGB ES wrote: > 2013/1/18 RGB ES > >> I started to create the User Guide pages on the wiki >> >> http://wiki.openoffice.org/wiki/Documentation/UserGuide >> >> > > I need some help here. There are now several pages covering the beginning > of the guide > > http://wiki.openoffice.org/wiki/Documentation/UserGuide/UI > http://wiki.openoffice.org/wiki/Documentation/UserGuide/Formatting > http://wiki.openoffice.org/wiki/Documentation/UserGuide/SearchReplace > http://wiki.openoffice.org/wiki/Documentation/UserGuide/AutoCorrect > http://wiki.openoffice.org/wiki/Documentation/UserGuide/Extensions > http://wiki.openoffice.org/wiki/Documentation/UserGuide/Options > and the sub page > http://wiki.openoffice.org/wiki/Documentation/UserGuide/Options/AOO > > All these pages needs proofreading (as you can see, English is not my > native language) and someone that fill their holes. > > The page about supported file formats is completely empty and needs an > author > http://wiki.openoffice.org/wiki/Documentation/UserGuide/FileFormats > > I think a general spellcheck guide is also needed, but not sure where to > put it on the "tree". Maybe below Formatting and before SearchReplace? > > Also, install guides are needed, maybe at the beginning of the guide? I > wrote a Linux install guide on the forums that can be "wikified": > > http://forum.openoffice.org/en/forum/viewtopic.php?f=74&t=50119 > > In the near future I can start with the Writer and Math guides, but someone > needs to take care of other components. > > Thoughts? Volunteers? ;) > > Regards > Ricardo > Ricardo; I have started proofreading http://wiki.openoffice.org/wiki/Documentation/UserGuide/UI. Regards Keith > > >> Even if there is some content scattered on those pages (the UI page and >> Java section under Options menu... someone needs to check my grammar) they >> are mainly empty right now, but on the following days I'll try to translate >> what it is already done on the ES wiki >> >> http://wiki.openoffice.org/wiki/ES/Manuales/GuiaAOO >> >> Regards >> Ricardo >> >> >> >> 2013/1/15 RGB ES >> >>> 2013/1/13 Regina Henschel >>> >>>> Hi Ricardo, >>>> >>>> RGB ES schrieb: >>>> >>>> >>>> >>>> >>>> I propose to omit the version number level. As can be seen for >>>> ODFAuthors it is unlikely, that all documents are new written for a new >>>> version and sometimes it is not needed at all. LibreOffice 4.0 is in RC1, >>>> but some documents are for 3.4, some for 3.5, and 3.6 is missing totally. >>>> The situation becomes worse, if you think of documentations in other >>>> languages. >>>> >>>> I propose this way: Use a hierarchy >>>> /wiki/Documentation/UserGuide/**Tips/Writer >>>> or >>>> /wiki/Documentation/UserGuide/**Writer/Tips >>>> I'm not sure about the best order. >>>> >>>> If some content becomes outdated and has to be replaced, then generate a >>>> new page with the same title, but a version addition. >>>> >>>> Example: A outdated content in the path >>>> /wiki/Documentation/UserGuide/**General/UI/Customize_Toolbar >>>> would be copied to a path >>>> /wiki/Documentation/UserGuide/**General/UI/Customize_Toolbar_**3_4 >>>> and the original page gets a comment line with a link to the old version >>>> and the old version gets a comment line back to the newer version. >>>> This has to be done by the person, who writes the new content. >>>> >>>> This has the advantage, that there will be no tree of empty pages, but >>>> the user will always come to the most actual document, when he starts in >>>> /wiki/Documentation and follows the tree. >>>> >>> >>> Good point! I like the idea of moving outdated content to sub-pages. >>> >>> >>> >>>> >>>> In the start, when not enough actual content is available, this single >>>> comment line can link to the existing ODFAuthors 3.3 or 3.2 documents or >>>> other suitable wiki pages. >>>> >>>> >>>> >>>> >>>>> The idea is to create all the pages at once, with just the categories >>>>> "Documentation" and "UserGuide" and a template similar to the one we >>>>> use on >>>>> the ES wiki(2) for "work in process new pages", that we can call "Draft" >>>>> (not sure if there is one already: I cannot find it). >>>>> >>>> >>>> Creating a new "UserGuide" section is OK, but same other sections need >>>> to be there from the beginning too. I think of pathes to the developers >>>> guide, to the building guide, to the QA tutorials, to the Calc functions >>>> reference. >>> >>> >>> Sure. We can update the main documentation page(1) to gather all those >>> elements on one place. >>> >>> (1) http://wiki.openoffice.org/wiki/Documentation >>> >>> >>> >>>> >>>> >>>> >>>>> In parallel, we can start discussing about writing style, screenshots >>>>> (desktop theme...) and related problems on other topics. >>>>> >>>> >>>> There is the page http://wiki.openoffice.org/** >>>> wiki/Documentation/Dashboard/**Wiki_Editing_Policy. >>>> It is already fairly good, and can be used as start. Adaption to AOO is of >>>> cause needed. >>> >>> >>> Thanks for the link! Looking there I see that the DraftPage template is >>> already present: {{Documentation/DraftPage}} >>> >>> >>> >>>> >>>> >>>> >>>>> After "seeding" some pages with content we start a call for authors and >>>>> the >>>>> "real writing"(3). Finally, when the author is ready he/she calls for >>>>> review/proof reading and when every is OK we delete the "Draft" >>>>> template. >>>>> >>>>> What do you think? >>>>> >>>> >>>> I fear, a lot a pages will stay "draft" for ever. >>>> >>>> What are your plans about the old Dokumentation hierarchy ? >>>> http://wiki.openoffice.org/**wiki/Documentation/Dashboard/** >>>> Wiki_Editing_Policy#Structure_**of_the_Documentation_Section_** >>>> of_the_Wiki >>> >>> >>> >>> No plans, for the moment. I just tried to start the discussion for a self >>> contained 4.0 user guide written from scratch and easy to maintain. >>> >>> The structure of the Documentation section on the wiki is indeed quite >>> complex and it is difficult for a new user to tell apart what's still >>> valid. Maybe we need to make a completely fresh start here, moving old >>> content to a "legacy" section... but on the other hand we cannot left the >>> site empty. >>> >>> Regards >>> Ricardo >>> >>> >>> >>>> >>>> >>>> Kind regards >>>> Regina >>>> >>>> >>> >> >