Hi :) At the moment i don't think details such as that really matter. It's more important to focus on just getting through the guides quickly and getting the first releases "out there" asap. Later on, in the next releases, it might be good to agree on details and get things more consistent. At the moment we just need the first releases "out there" fast.
I mostly work in forums, mailing lists and direct contact trying to help people by pointing them to the right pages (or chapters) in documentation so "my take" might be very different. I tend to favour "Camel Case" for words that are joined together, eg QuickStarter, LibreOffice and i also do that with widely used acronyms such as Ram, Cpu, Gnu, Wine, LxDE to avoid suddenly shouting out a word that is becoming quite common place. If i have to spell out what the acronym stands for then i use capitals that first time. For example GNU (=Gnu is Not Unix) and WINE (=Wine Is Not an Emulator) and i have started using that unnecessary = sign to clarify what the brackets are about. I've probably been dealing with a lot of people that are not used to reading lately and the annoying = seems to help. People seem to either ignore it, find it friendly, or appreciate it - i've not had much feedback about it but had less follow-up questions when i use it. I've not had any complaints which is amazing imo. Obviously there are exceptions such as KDE, USA, GB (=Great Britain) although i do tend to do Uk and Gb (=Giga-bytes). For the specific examples already mentioned i would favour toolbar, QuickStarter, AutoRecovery (or perhaps auto-recovery if pushed) I think i would prefer that contributors get mentioned vertically or in columns, even if their work has subsequently been overwritten or replaced. I prefer most recent on top or alphabetically but again these are finesses that can be left for now and sorted out in subsequent releases, after there has been discussion to vote on preferences. There is a guide about what work needs to be done (i think) urgently in some sort of "Resources" section or perhaps "Miscellaneous"? Regards from Tom :) ________________________________ From: John Cleland <[email protected]> To: [email protected] Sent: Sat, 30 July, 2011 11:26:49 Subject: [libreoffice-documentation] Chapters 1 and 2 reviewed Hi Jean I knew nothing about impress but worked my way through chapter one and two. I was able to follow the guide easily. Made some minor changes Chapter One Changed documentation address to [email protected] Chapter two Added sentence on where to find drawing toolbar, it took me a little while to work out where it was. I expected it to be at the top of the screen it was at the bottom. One of the tips missed formatting. Is there a standard way of referring to things, for example Toolbar,toolbar or ToolBar. QuickStarter, Quickstarter. AutoRecovery or Auto Recovery. Is there a standard way of sorting the list of contributors, sometimes done horizontally, sometimes vertically. Will continue with the rest of the chapters Regards John Cleland -- Unsubscribe instructions: E-mail to [email protected] Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ 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 [email protected] Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ 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
