[libreoffice-documentation] wanting clarification on how to start submitting(?) updates to docs
after a quick perusal of the last few days of posts on this list, i just want to make sure i'm starting off the right way in reviewing the current docs and noting content that could be updated. as i read it, with my brand new alfresco account, i can go here: http://alfresco.libreoffice.org/ log in, then go to Company Home -> English Content -> Documentation and select, say, the "Getting Started Guide." i can see that the various chapters of that guide are individual .odt files so once i got confident, i could check one out, make changes, then check it back in (not prepared to do that just yet). for example, say i was perusing the "SettingUpLibreOffice" chapter, where i notice a couple of things: * a couple references to "LibraOffice" rather than "LibreOffice", which i assume are simple typoes * there's also a reference to the "Help formatting" option (allegedly under LibreOffice->General) which i simply don't see in my 3.4.1 writer session. is that the sort of thing that one starts off doing -- just some simple fixes? or have i misread something? thanks. rday p.s. i also see a reference to "Enable systray quickstarter on Linux" but i don't see that anywhere in my linux session. perhaps i just didn't look hard enough. -- Robert P. J. Day Ottawa, Ontario, CANADA http://crashcourse.ca Twitter: http://twitter.com/rpjday LinkedIn: http://ca.linkedin.com/in/rpjday -- Unsubscribe instructions: E-mail to documentation+h...@global.libreoffice.org Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] wanting clarification on how to start submitting(?) updates to docs
On Mon, 2011-07-04 at 06:33 -0400, Robert P. J. Day wrote: > after a quick perusal of the last few days of posts on this list, i > just want to make sure i'm starting off the right way in reviewing the > current docs and noting content that could be updated. > > as i read it, with my brand new alfresco account, i can go here: > > http://alfresco.libreoffice.org/ > > log in, then go to > > Company Home -> English Content -> Documentation > > and select, say, the "Getting Started Guide." i can see that the > various chapters of that guide are individual .odt files so once i got > confident, i could check one out, make changes, then check it back in > (not prepared to do that just yet). > > for example, say i was perusing the "SettingUpLibreOffice" chapter, > where i notice a couple of things: > > * a couple references to "LibraOffice" rather than "LibreOffice", > which i assume are simple typoes > > * there's also a reference to the "Help formatting" option > (allegedly under LibreOffice->General) which i simply don't see in my > 3.4.1 writer session. > > is that the sort of thing that one starts off doing -- just some > simple fixes? or have i misread something? thanks. > > rday > > p.s. i also see a reference to "Enable systray quickstarter on Linux" > but i don't see that anywhere in my linux session. perhaps i just > didn't look hard enough. Certainly if you see errors, either typos or factual errors, correcting them is a good thing. Check out, make changes (with changing tracking on), check back in... as you said. However, be aware that if you're using 3.4.1 you will definitely see some differences from what is in the book for 3.2/3.3. "Enable systray Quickstarter" appears to be one of them; at least, I see it in 3.3.3 but not in 3.4.1. If you update a chapter for 3.4.1, you should just download it (but not check it out) and then put it into Drafts when you are done. Other items may be operating system specific. We try to note those in the books, but sometimes miss them. And other discrepancies may just be errors: things that were in OOo but are not in LO and didn't get deleted when the books were rebranded. Those are certainly good to spot and deal with. At this time we are trying to finish a full set of books for 3.3, because some people will be using that for awhile yet. The Impress Guide in particular needs help! It's been "rebranded" from OOo to LO, but most of the chapters have not yet been checked to see if they are correct for LO3.3. I know there are some differences between OOo and LO Impress, but I don't recall what they are. Also, Impress is different in 3.4.1 from 3.3, so that book will need updating to 3.4.1 at some point. Draw Guide is also being worked on, but Martin Fox is doing the updates and others are doing the screenshots, so that is less urgent than the Impress Guide. If anyone starts updating to 3.4.x, the files should be renamed in some way so we don't get the 3.3.x chapters and the 3.4.x chapters mixed up. In some cases, the differences will be trivial or minor and might best be accommodated by a simple note or flag in a single chapters. We haven't talked about updating yet and how to best handle minor vs major changes in the program. One potentially awkward area is screenshots, when the functions haven't changed (or not much) but the visual appearance has. Er... that was a somewhat roundabout answer, wasn't it? I hope it WAS an answer and not just a lead-in to more questions. --Jean -- Unsubscribe instructions: E-mail to documentation+h...@global.libreoffice.org Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] wanting clarification on how to start submitting(?) updates to docs
Hi :) Yes, at some point the Documentation Team are going to need to have at least 2 separate sets of Documentation = 1 for stable branch (3.3.x) and one for "early adopters" (development/cooking) branch. Hopefully there is going to be some neat trick that makes that easier. Within the 3.3.x branch the 3.3.0, 3.3.1 and 3.3.2 have 1 year's support. However, lets not worry about that until after the 3.3.3 documentation is complete. Regards from Tom :) From: Jean Hollis Weber To: documentation@global.libreoffice.org Sent: Mon, 4 July, 2011 12:01:52 Subject: Re: [libreoffice-documentation] wanting clarification on how to start submitting(?) updates to docs On Mon, 2011-07-04 at 06:33 -0400, Robert P. J. Day wrote: > after a quick perusal of the last few days of posts on this list, i > just want to make sure i'm starting off the right way in reviewing the > current docs and noting content that could be updated. > > as i read it, with my brand new alfresco account, i can go here: > > http://alfresco.libreoffice.org/ > > log in, then go to > > Company Home -> English Content -> Documentation > > and select, say, the "Getting Started Guide." i can see that the > various chapters of that guide are individual .odt files so once i got > confident, i could check one out, make changes, then check it back in > (not prepared to do that just yet). > > for example, say i was perusing the "SettingUpLibreOffice" chapter, > where i notice a couple of things: > > * a couple references to "LibraOffice" rather than "LibreOffice", > which i assume are simple typoes > > * there's also a reference to the "Help formatting" option > (allegedly under LibreOffice->General) which i simply don't see in my > 3.4.1 writer session. > > is that the sort of thing that one starts off doing -- just some > simple fixes? or have i misread something? thanks. > > rday > > p.s. i also see a reference to "Enable systray quickstarter on Linux" > but i don't see that anywhere in my linux session. perhaps i just > didn't look hard enough. Certainly if you see errors, either typos or factual errors, correcting them is a good thing. Check out, make changes (with changing tracking on), check back in... as you said. However, be aware that if you're using 3.4.1 you will definitely see some differences from what is in the book for 3.2/3.3. "Enable systray Quickstarter" appears to be one of them; at least, I see it in 3.3.3 but not in 3.4.1. If you update a chapter for 3.4.1, you should just download it (but not check it out) and then put it into Drafts when you are done. Other items may be operating system specific. We try to note those in the books, but sometimes miss them. And other discrepancies may just be errors: things that were in OOo but are not in LO and didn't get deleted when the books were rebranded. Those are certainly good to spot and deal with. At this time we are trying to finish a full set of books for 3.3, because some people will be using that for awhile yet. The Impress Guide in particular needs help! It's been "rebranded" from OOo to LO, but most of the chapters have not yet been checked to see if they are correct for LO3.3. I know there are some differences between OOo and LO Impress, but I don't recall what they are. Also, Impress is different in 3.4.1 from 3.3, so that book will need updating to 3.4.1 at some point. Draw Guide is also being worked on, but Martin Fox is doing the updates and others are doing the screenshots, so that is less urgent than the Impress Guide. If anyone starts updating to 3.4.x, the files should be renamed in some way so we don't get the 3.3.x chapters and the 3.4.x chapters mixed up. In some cases, the differences will be trivial or minor and might best be accommodated by a simple note or flag in a single chapters. We haven't talked about updating yet and how to best handle minor vs major changes in the program. One potentially awkward area is screenshots, when the functions haven't changed (or not much) but the visual appearance has. Er... that was a somewhat roundabout answer, wasn't it? I hope it WAS an answer and not just a lead-in to more questions. --Jean -- Unsubscribe instructions: E-mail to documentation+h...@global.libreoffice.org Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted -- Unsubscribe instructions: E-mail to documentation+h...@global.libreoffice.org Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] wanting clarification on how to start submitting(?) updates to docs
Hi Robert, On Mon, Jul 4, 2011 at 1:33 PM, Robert P. J. Day wrote: > after a quick perusal of the last few days of posts on this list, i > just want to make sure i'm starting off the right way in reviewing the > current docs and noting content that could be updated. > > as i read it, with my brand new alfresco account, i can go here: > > http://alfresco.libreoffice.org/ > > log in, then go to > > Company Home -> English Content -> Documentation > > and select, say, the "Getting Started Guide." i can see that the > various chapters of that guide are individual .odt files so once i got > confident, i could check one out, make changes, then check it back in > (not prepared to do that just yet). Yes, that's the way. > for example, say i was perusing the "SettingUpLibreOffice" chapter, > where i notice a couple of things: > > * a couple references to "LibraOffice" rather than "LibreOffice", > which i assume are simple typoes Yes, quite right. > * there's also a reference to the "Help formatting" option > (allegedly under LibreOffice->General) which i simply don't see in my > 3.4.1 writer session. Jean already commented on possible differences between versions, so I don't need to add more. > is that the sort of thing that one starts off doing -- just some > simple fixes? or have i misread something? thanks. Yes, this is already very useful contribution and a great way to get started. Again, Jean already said things in reply to you, but basically you're on the right track. > p.s. i also see a reference to "Enable systray quickstarter on Linux" > but i don't see that anywhere in my linux session. perhaps i just > didn't look hard enough. What Linux are you using? If you're on Ubuntu 11.04, the quickstarter is not currently functioning under Unity. But, in any case, the quickstarter needs to be activated first (Tools > Options > LibreOffice > Memory > Enable systray QuickStarter) and then you need to log-out and log back in to your session (or simply restart your system). Only after that would you see it in the systray. Any problems or questions you have with Alfresco, don't hesitate to ask and I'll answer as quickly as possible. A big thanks for working on docs. :-) -- David Nelson -- Unsubscribe instructions: E-mail to documentation+h...@global.libreoffice.org Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] wanting clarification on how to start submitting(?) updates to docs
On Tue, Jul 5, 2011 at 05:06, David Nelson wrote: > On Mon, Jul 4, 2011 at 1:33 PM, Robert P. J. Day > wrote: >> p.s. i also see a reference to "Enable systray quickstarter on Linux" >> but i don't see that anywhere in my linux session. perhaps i just >> didn't look hard enough. > > What Linux are you using? If you're on Ubuntu 11.04, the quickstarter > is not currently functioning under Unity. But, in any case, the > quickstarter needs to be activated first (Tools > Options > > LibreOffice > Memory > Enable systray QuickStarter) and then you need > to log-out and log back in to your session (or simply restart your > system). Only after that would you see it in the systray. In 3.3.3 "Enable systray QuickStarter" appears in the options where you say, but (at least on my copy of 3.4.1) it is not there. This probably explains why Robert can't find it in 3.4.1. --Jean -- Unsubscribe instructions: E-mail to documentation+h...@global.libreoffice.org Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] wanting clarification on how to start submitting(?) updates to docs
On Mon, 4 Jul 2011, David Nelson wrote: > Hi Robert, > > On Mon, Jul 4, 2011 at 1:33 PM, Robert P. J. Day > wrote: > > > p.s. i also see a reference to "Enable systray quickstarter on > > Linux" but i don't see that anywhere in my linux session. perhaps > > i just didn't look hard enough. > > What Linux are you using? If you're on Ubuntu 11.04, the > quickstarter is not currently functioning under Unity. But, in any > case, the quickstarter needs to be activated first (Tools > Options > > LibreOffice > Memory > Enable systray QuickStarter) and then you > need to log-out and log back in to your session (or simply restart > your system). Only after that would you see it in the systray. ubuntu 11.04, running ubuntu classic (not unity), and i see no such setting under the "Memory" submenu. is the visibility of that setting dependent on some other selection? can someone else verify that they can see that option in LO 3.4.1? rday -- Robert P. J. Day Ottawa, Ontario, CANADA http://crashcourse.ca Twitter: http://twitter.com/rpjday LinkedIn: http://ca.linkedin.com/in/rpjday -- Unsubscribe instructions: E-mail to documentation+h...@global.libreoffice.org Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] wanting clarification on how to start submitting(?) updates to docs
Hi Robert, On Mon, Jul 4, 2011 at 11:43 PM, Jean Weber wrote: > In 3.3.3 "Enable systray QuickStarter" appears in the options where > you say, but (at least on my copy of 3.4.1) it is not there. This > probably explains why Robert can't find it in 3.4.1. Jean just pointed out that this feature is not there in 3.4.1. Myself, I prefer to stick with the version of LibreOffice currently being distributed by Ubuntu, so I've still got 3.3.2 for the moment - I'm sure Ubuntu will be pushing out the new version of LibreOffice sometime in the very near future. So the new location of the "Enable systray QuickStarter" check box is something that will require updating at a point in the future, since it appears to have changed. OT: In any case, my experience with 10.04 and 11.04 is that the QuickStarter is not functioning properly at the present time in Ubuntu: when it is present in memory, you will be unable to restart your system or - IIRC - log out of your session. -- David Nelson -- Unsubscribe instructions: E-mail to documentation+h...@global.libreoffice.org Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted