Incorrect Terminology for Installing on a Mac

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

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

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

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

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

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

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

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

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

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

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

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

I'm happy to help out as much as I can in my limited available time, and I
do speak HTML in case that helps. In addition to putting my Mac installation
instructions on the site, I noticed lots of minor copyediting things I can
fix up.

I've signed up, so when you get a chance you can give me author rights
there.

Hal

ok, I've registered. the Why? pages under the Home page sound great.

-- jdc

Yes, I have created the screenshots. Will implement very soon.

Hi Hal, :slight_smile:

I added you as author. Would you maybe like to work on your Mac
install instructions? They're up there now, but could do with a bit of
re-formatting...

David Nelson

Hi Jeremy, :slight_smile:

ok, I've registered. the Why? pages under the Home page sound great.

I added you as author. You don't think they need padding out a bit
with a *little* more text? I say that because search engine spiders
eat words and, unless you put at least a reasonable amount of content
on the page, they don't have material to index.

What are your thoughts about that? Although some comments at the
website confcall last night were that there's too much text on some
pages. Other people said that it's just that we need a good
page-setting job to be done, with some text going into boxes, with the
Design team providing graphics, Flash content, and other multimedia
content.

We certainly need more screenshots, too.

What do you think, guys?

In any case, I think it's a great thing for docs people to be closely
involved in work on the website content, because you have the writing
skills as well as good technical knowledge of the product.

David Nelson

The instructions I see on the website are not the ones I wrote. They are a
slightly edited version, with added screenshots, of the original
instructions. I assume this is the work Michael just did. Shall I replace
what's on that page with the instructions I wrote? Or what would you prefer?

Practical question: how do I actually get write access to the pages? Log in
somewhere (where?), then what? Are they editable online? Or what do I do?
Where can I find out what to do, and how to do it? I'm usually a quick study
if you point me in the right direction.

Hal

Hi Hal, :slight_smile:

My 2 cents would be that you should post the instructions you wrote, and replace
what's there.

To log in, go to http://libreoffice.org/admin

To help you get familiar with working with pages on SilverStripe:

1) SilverStripe demo site: http://demo.silverstripe.com/
2) General documentation on SilverStripe, the CMS used for libreoffice.org:
[1] http://en.wikipedia.org/wiki/SilverStripe
[2] http://en.wikipedia.org/wiki/SilverStripe#Documentation
[3] http://doc.silverstripe.org/
3) Documentation that will be especially useful to you when learning
to contribute work via the SilverStripe back-end:
[1] http://userhelp.silverstripe.org/for-website-content-editors/creating-and-editing-content/
[2] http://userhelp.silverstripe.org/for-website-content-editors/working-with-images-and-documents/

If you need any help from me, please do post back.

David Nelson

Sorry,
My mistake. I didn't go through and check the full instructions.
Making an assumption makes an ass out of ... well me.

Going back now.

Mike