Incorrect Terminology for Installing on a Mac

Documentation General
#1

The terminology used in "Installation of LibreOffice 3.3 on Macintosh" is incorrect
http://www.libreoffice.org/get-help/installation/macintosh/

    "Open the downloaded DMG file by double-clicking on it in the Downloads folder, or single
    clicking on the Taskbar launcher drawer corresponding to Downloads (on a standard Macintosh
    installation set-up, it is usually on the right-hand side of the task bar)."

There is no "Taskbar" on a Mac. The correct term is the "Dock".

There is no "launcher drawer". An icon for the Downloads folder is located in the Dock. (Folders in the Dock are referred to as “stacks.”)

Please use correct terminology for Macs. Incorrect terminology will cause confusion for inexperienced users, and make experienced users laugh at you and dismiss using your product.

Larry

#2

At David Nelson's request, I rewrote that page some time ago, but the
revised version has not yet replaced the one on the website.

I completely agree about using correct terminology for Macs.

Hal

#3

Hi, :slight_smile:

The terminology used in "Installation of LibreOffice 3.3 on Macintosh" is
incorrect
http://www.libreoffice.org/get-help/installation/macintosh/

It will be updated today. :wink:

David Nelson

#4

Two weeks later and the terminology is still incorrect.

Larry

#5

Larry, I will update the terminology you are referring to.

Is there any chance you could take some screenshots of this
installation process so we can spice the installation instructions up
a bit and further reduce confusion about what UI aspects they are
referring to.
Apple is a special case when it comes to UI and terminology, so it
would be good to get it right in order to invite native Mac users to
use and contribute to LibreOffice.

Thanks,
Michael Wheatland

#6

time ago. David was going to upload my doc to the website but sounds like he
didn't get around to it.

If you'd like, I can send my document to you to deal with.

No need for Larry or anyone to redo this work, unless of course I got it
wrong. :wink:

Hal

#7

I have now put the file (mac-install.odt) in the "Various" section under
"LibreOffice Docs" on the Alfresco site.

Hal

#8

Could you email it directly to me and I will update the site

Thanks
Mike

#9

Hi Hal, Michael, :slight_smile:

Mike, I've mailed you Hal's instructions. Thanks for jumping in on this.

We're going to have to re-do the Linux instructions, too. The one's
that are there are pretty unwieldy, because they try to cater to too
many Linux distros in one document. They do work, but the task looks
daunting when you read them, whereas it's not anything like as
difficult as it looks.

There's a set at softpedia.com [1] for Ubuntu that is much more
friendly, plus Rogerio Luz Coelho has been working on revising my
original draft on the wiki [2].

Plus Ubuntu now has LibreOffice available via a repository (although
that doesn't mean we don't have to provide the instructions on the
wiki for the community-supplied download).

This is definitely a "to do" for the website.

I'm really hoping that after tonight's website team confcall we can
actually get the website team working *as a team* and that maintaining
the website is not going to be a one-man effort anymore...

[1] http://news.softpedia.com/news/How-to-Install-LibreOffice-in-Ubuntu-10-10-and-Ubuntu-10-04-177762.shtml
[2] http://wiki.documentfoundation.org/Installing_LibreOffice_on_Linux

David Nelson

#10

Hi, :slight_smile:

Could you email it directly to me and I will update the site

Thanks
Mike

I saw from the commits that you updated terminology in the existing
instructions, but I was wondering if you're planning to fully format
and post Hal's instructions with the screenshots she took?

Hal, I apologise for having been tardy with your work, but there has
been a lot of other stuff to do on the site, so it became a secondary
priority.

Would you by any chance like to get an account on the libreoffice.org
website and do a little work there yourself?

If you are, please do sign up at
http://www.libreoffice.org/ForumMemberProfile/register and I'll give
you author rights there

The invitation is also open to other docs team members: we're really
short of help from people with a really good level of written English
and technical writing experience.

David Nelson

#11

Hi David,

The invitation is also open to other docs team members: we're really
short of help from people with a really good level of written English
and technical writing experience.

I know you said you gave me Author rights to that part of the site, but
I am still unable to access it. All I can see (and edit/publish) are the
pages on the French (which I was doing yesterday) and German parts of
the website. Did something go wrong somewhere in all the website updates
with some of the user permissions ?

Alex

#12

Hi Alex, :slight_smile:

I know you said you gave me Author rights to that part of the site, but
I am still unable to access it. All I can see (and edit/publish) are the
pages on the French (which I was doing yesterday) and German parts of
the website. Did something go wrong somewhere in all the website updates
with some of the user permissions ?

You're good to go, I gave you author rights.

Would you like me to point you at some content that needs work? Or do
you have any ideas of your own? I'd love to get the work organized in
a coordinated way if possible, without stifling anyone's creativeness
or stepping on anyone's toes.

David Nelson

#13

You're good to go, I gave you author rights.

Fine, thanks David.

Would you like me to point you at some content that needs work? Or do
you have any ideas of your own? I'd love to get the work organized in
a coordinated way if possible, without stifling anyone's creativeness
or stepping on anyone's toes.

Probably Mac related stuff, with the correct terminology this time :-),
and also probably Base related stuff - hopefully I'm not treading on
anyone's toes by doing that ?

Alex

#14

Ok, I'll bite. May I have a libreoffice.org author signin, please?
And I would like to be pointed at some content that needs work.

-- jdc

#15

Hi, :slight_smile:

Probably Mac related stuff, with the correct terminology this time :-),
and also probably Base related stuff - hopefully I'm not treading on
anyone's toes by doing that ?

Definitely not. Would you like to take a look at the Base sub-page of
the Features section? That would need some developing... Like some
sub-pages exploring the major features of Base in more detail, for
instance? Or what are your ideas?

David Nelson

#16

Hi Jeremy, :slight_smile:

Ok, I'll bite. May I have a libreoffice.org author signin, please?
And I would like to be pointed at some content that needs work.

Please sign-up at
http://www.libreoffice.org/ForumMemberProfile/register and I'll give
you author rights there once you post back.

My idea would be that the Why? pages under the Home page need developing.

Also, all the stuff under the Features section needs developing. For
instance, under Calc, the basic page needs looking at by someone who's
a real Calc lover, and the major features of Calc would need exploring
in sub-pages, IMHO.

In any case, identify something that interests you, and I'll mark it
off in my head as "checked out" and make sure no-one steps on your
toes while you're working. (There's no automated way to do that at
present.)

David Nelson

#17

Driver Connectivity and setup are often problematic for many people, so
I could look into that. I have written documents in the past with regard
to that topic in the past, and I could no doubt do the same here. My
only concern at the moment is the depth (as in sub-page levels) one can
go to without the presentation being screwed up. My understanding is
that we have to stick to a maximum of three levels, and anything deeper
is problematic ?

Alex

#18

Hi Alex, :slight_smile:

Driver Connectivity and setup are often problematic for many people, so
I could look into that. I have written documents in the past with regard
to that topic in the past, and I could no doubt do the same here. My
only concern at the moment is the depth (as in sub-page levels) one can
go to without the presentation being screwed up. My understanding is
that we have to stick to a maximum of three levels, and anything deeper
is problematic ?

Please do go for it. Coverage of Base is a major lack right now, and
someone posted on Discuss about that already today.

Best to avoid going further than 3 pages deep right now, or else to
explore solutions via lateral thinking, but if you figure out content,
we can work on how to integrate it into the site.

But the current theme would need attention from Design if we start
going too deep in levels.

David Nelson

#19

So do you want me to give a polished version for the Linux install
instructions?

I could transform the wiki page into a formatted .odt for starters ...

Rogerio

#20

Hi, :slight_smile:

So do you want me to give a polished version for the Linux install
instructions?

I could transform the wiki page into a formatted .odt for starters ...

Rogerio

It would cut out a conversion process if you could work directly on
the SilverStripe site. Would you be willing to do that?

David Nelson

Impressum (Legal Info) | Datenschutzerklärung (Privacy Policy)   Content on this site is licensed under a Creative Commons Attribution Share Alike 3.0 license.