Chapters 1 and 2 reviewed

[JohnCleland]

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 documentation@global.libreoffice.org

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

[jeanweber]

Is there a standard way of referring to things, for example

Toolbar,toolbar or ToolBar. QuickStarter, Quickstarter. AutoRecovery or
Auto Recovery.

Yes, but we haven't listed them all in the style guide yet. The general rule
is: use the same as whatever is on the UI, but in some cases (such as
"toolbar") that doesn't help much because the term either doesn't appear on
the UI or it's capitalised inconsistently there.

Is there a standard way of sorting the list of contributors, sometimes

done horizontally, sometimes vertically.

No, or at least not yet. Mostly what's happened is the list starts off
vertical (one to a line) and then gets turned into three-to-a-line when
everything no longer fits onto one page. Also some are sorted
alphabetically, some in the order in which they worked on the file, and
others have the major contributor(s) listed first. I prefer the latter
style, but others prefer one of the others, so the lists have varied.

Will continue with the rest of the chapters

Great, thanks.

Jean

[Tom_Davies]

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

[Tom_Davies]

Hi
+1
I was mostly thinking about things that weren't in the UI but using the examples
given in the original post. Sorry! That was really confusing!

Perhaps we could agree on ToolBar? Although that might make us inconsistent
with the rest of the world? It might make things clearer for people that are
very new to computers?

I like the major contributors at the top along with most recent contributors but
it's difficult to judge who did the most when people have a tendancy to be shy
about it. Sometimes it's obvious of course but not always.
Regards from
Tom

[jeanweber]

Absolutely NOT. That version is not used anywhere in the docs at this
point, nor in the Help. The preferred capitalisation is "toolbar": that
is, no caps unless of course at the start of a sentence.

Sometimes the docs or Help use "Toolbar" but we have been moving towards
standardising on lower case.

--Jean

[Tom_Davies]

Hi
Lol, ok, ok.
Regards from
Tom