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
