[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[libreoffice-documentation] Re: My work on the Getting Started Guide
- Subject: [libreoffice-documentation] Re: My work on the Getting Started Guide
- From: Jean Weber <email@example.com>
- Date: Sun, 20 Nov 2011 10:33:55 +1000
- To: Documentation@global.libreoffice.org
I've now looked at the file and will respond to the questions I
skipped in my last note.
David Michel firstname.lastname@example.org wrote,> p18
> Is my new text satisfactory?
1) We do not use the term "radio button". Often the term "option" is a
good choice, but in this case I would use "action" because the heading
above the two radio buttons is "Action".
2) With rare exceptions, we do not use the phrase "allows you to". In
this case a better wording would be "Select the Move action to..." In
other situations the phrase "Use the xxxx option to..." might work
best. The general principle is: use imperative voice (for example,
"Choose xxxx to do x") or an infinitive phrase such as "To do x,
3) Although the two sentences you flagged are a bit redundant, in
introductory material like this we've found that it's often best to
make statements that might seem obvious to us.
4) I am sure there are other ways to move sheets, at least in some
circumstances, not just using this dialog. For example, you can
click-and-drag a sheet tab. This section should mention those other
methods. (You may need to play around a bit to figure out what they
5) The first paragraph on page 17 under the heading needs to be amended.
6) Formatting tips: Do not insert blank paragraphs by pressing Enter.
Do not use two spaces after a full stop (period); use only one. Do not
leave blank spaces at the end of a paragraph. If you turn on
end-of-paragraph markers, you'll be able to see blank paras and spaces
at the ends of paras easily.
7) Do not put quotation marks around the names of options, buttons,
list boxes, or any other part of a dialog. Instead, use the
OOoMenuPath character style or (in some cases) the OOoEmphasis
character style, or (in some cases, such as the name of the dialog) no
special style. The style descriptions in the template instructions
should give a good idea of what style to use when. Unfortunately, many
of the chapters do not use the agreed-upon styles, so following the
examples of use in a chapter may lead you astray.
> I am unclear where to put the section on data analysis. I put it on page 36.
I think that's good. However, "Analyzing data" is a better title than
"Using data analysis". BTW, you have used "TextBody" instead of
"OOoTextBody" as the para style in that section.
> What should I use as a model for formatting the individual items?
You could use either bullet points or a definition list (choosing the
appropriate para styles). In this case, I think a definition list
would be good.
> I borrowed and edited text from the Guide for the text about formulas and functions.
> "Global" was added to the email address.
You changed the visible address, but you failed to change the
hyperlink. (A common mistake.)
> Screenshots:>> Figures 1-5 show slight differences between compared with version 3.4.
> Is this worth changing? The boxes and arrows are ingrained in the images.
The only difference I can see is an icon in Fig1 and an icon in Fig 5,
though I could be missing something. I may have the original .ODG
files from which these PNG images were created, or a bit of fiddling
in GIMP will fix the icons quickly. (I do this a lot, to avoid
recapturing and relabeling.)
> Figure 6: Version 3.4's box is gray, but the content is exactly the same.
> Figure 8: Same question as #6.
> In fact, as I have been looking at the screenshots, the only issue seems to be gray versus the blue of version 3.4.
Whether items are gray or white usually depends on the operating
system and the desktop theme in use. The blue is NOT related to the
version of LibreOffice, but to your o/s.
BTW, the Figure 15 that you added appears to have been taken on
Windows XP. Please change the Windows desktop from the Blue theme to
the Silver theme, so any images you take will more closely match
others in the book. It's in Settings > Control Panel > Display >
Appearance tab; near the bottom is "Color scheme": choose Silver.
Although the above list of corrections may seem formidable, what you
have done is fairly typical for new contributors who haven't got used
to our writing and formatting style yet. I'll hand it back to you now
for another try.
On Sat, Nov 19, 2011 at 08:29, Jean Weber <email@example.com> wrote:
> David Michel firstname.lastname@example.org wrote,
>> No, I did not get sucked into a black hole! I made changes, and the new file is:
>> 0105GS34-SECONDDraftGettingStartedWithCalc DavidMichel.odt
> I've taken a copy of the file and will look at it later today.
> Meanwhile, here are answers to a few of your questions.
>> I went to: http://extensions.libreoffice.org/extension-center/template-changer
>> and downloaded the template changer without a problem;
>> However, at: https://wiki.documentfoundation.org/Documentation/howto/install_extension
>> It said: "There is currently no text in this page."
>> So, nothing was done with the template.
> Installing extensions is covered in several documents, including
> It's also briefly covered in producing-LibreOffice-userguides.odt,
> which is available in the Resources > Drafts folder on Alfresco. That
> document also describes many other things you need to know when
> writing or revising user guide chapters.
> I also recommend reading using_LibreOffice_template.odt, which
> describes all the styles used in our user guides and what they should
> be used for, and LibO-style-guide.odt for some tips on our preferred
> writing style and terminology.
> Regarding that empty wiki page: I assume you followed a link from
> somewhere to get there. Do you recall where you got that link? We'll
> need to fix it so it doesn't cause problems for other people.
>> I did a search for "->" to replace with only ">", but found none.
> The items needing replacement are actual arrows, and you should see
> them in all the menu paths given in the chapter. To find them by
> searching, you'll need to copy one and paste it into the Find &
> Replace dialog. When you do replace them, you need to ensure that all
> the ">" are in the correct character style (OOoMenuPath).
> More later.
Unsubscribe instructions: E-mail to email@example.com
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] Re: My work on the Getting Started Guide||David Michel <firstname.lastname@example.org>|
|[libreoffice-documentation] Re: My work on the Getting Started Guide||Jean Weber <email@example.com>|
- Prev by Date: [libreoffice-documentation] Introducing Myself - Joining Your Efforts
- Next by Date: Re: [libreoffice-documentation] Introducing Myself - Joining Your Efforts
- Previous by thread: [libreoffice-documentation] Re: My work on the Getting Started Guide
- Next by thread: Re: [libreoffice-documentation] Re: My work on the Getting Started Guide