Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-28 Thread Tom Davies
Hi :)

When people open coding brackets please remember to close them again.  It feels 
like scrapping fingernails down a blackboard when you leave them open!

Yday or before someone did  without the corresponding !

Regards from
Tom :)





From: Hal Parker 
To: documentation@libreoffice.org
Sent: Fri, 28 January, 2011 4:31:06
Subject: Re: [libreoffice-documentation] Re: Incorrect Terminology for 
Installing on a Mac

On Fri, Jan 28, 2011 at 1:14 PM, David Nelson wrote:

> Hi Hal, Jeremy :-)
>
> I upgraded your permissions to Publisher. When you feel your content
> is ready, you can publish straight to the Web.
>
> @Hal: a possible to-do: You worked on compiling a book of the Getting
> Started Guide. I still haven't had time to post that in the docs
> section at http://www.libreoffice.org/get-help/documentation/
>
> Do you feel like doing that? I won't have much time over the next
> couple of days, but could do so beginning of next week, if not.
>

If I can figure out how to upload a file, I'll do that. I'm sure it's not
difficult, just one more thing to learn. :-)

Thanks for the Publisher permission. Ah, the power! 

Hal

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


  
-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-27 Thread Hal Parker
On Fri, Jan 28, 2011 at 3:24 PM, David Nelson wrote:

> Hi, :-)
>
> On Fri, Jan 28, 2011 at 12:31, Hal Parker  wrote:
> > If I can figure out how to upload a file, I'll do that. I'm sure it's not
> > difficult, just one more thing to learn. :-)
>
> What I've been doing so far is to link to the files posted in the
> Documentation section of the wiki... I've been considering that page
> as the current home for user-ready downloadable content, since it's
> the most-accessible place for most people. HTH.
>

Ah, yes, I remember this now. Thanks for the memory jog.

Hal

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-27 Thread David Nelson
Hi, :-)

On Fri, Jan 28, 2011 at 12:31, Hal Parker  wrote:
> If I can figure out how to upload a file, I'll do that. I'm sure it's not
> difficult, just one more thing to learn. :-)

What I've been doing so far is to link to the files posted in the
Documentation section of the wiki... I've been considering that page
as the current home for user-ready downloadable content, since it's
the most-accessible place for most people. HTH.

> Thanks for the Publisher permission. Ah, the power!  evilly>

Enjoy the reign of evil. :-D

David Nelson

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



[libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-27 Thread Alexander Thurgood
Le 28/01/11 05:31, Hal Parker a écrit :

Hi all,

I have since modified Hal's contribution to include a brief discussion
about a quirk of the current LangPack installer whereby it will not
appear in the foreground if other application windows are open. This can
be confusing for the unaware, as the only indication that anything is
happening is that an icon starts jumping up and down in the dock, which
is not the first place one would necessarily look.

As this behaviour is caused by an error in the AppleScript used for
installation of the LangPack, I have also filed a bug and included a
corrected script which does bring the installation window to the
foreground. However, this correction will only be included in future
releases of LibreOffice, as I doubt that the Langpacks will be rebuilt
in-between.


Alex


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-27 Thread Hal Parker
On Fri, Jan 28, 2011 at 1:14 PM, David Nelson wrote:

> Hi Hal, Jeremy :-)
>
> I upgraded your permissions to Publisher. When you feel your content
> is ready, you can publish straight to the Web.
>
> @Hal: a possible to-do: You worked on compiling a book of the Getting
> Started Guide. I still haven't had time to post that in the docs
> section at http://www.libreoffice.org/get-help/documentation/
>
> Do you feel like doing that? I won't have much time over the next
> couple of days, but could do so beginning of next week, if not.
>

If I can figure out how to upload a file, I'll do that. I'm sure it's not
difficult, just one more thing to learn. :-)

Thanks for the Publisher permission. Ah, the power! 

Hal

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-27 Thread Hal Parker
On Fri, Jan 28, 2011 at 11:44 AM, Michael Wheatland <
mich...@wheatland.com.au> wrote:

> > Having done this page, I don't think I will get very involved in website
> > work. Learning to use Silverlight AND Alfresco AND LibreOffice itself is
> > overloading my brain. ;-) So I'll concentrate my limited time and
> brainpower
> > on the user guides and only jump into website work occasionally to help
> on
> > specific needs.
>
> SilverSTRIPE ...
> (Silverlight is a MS product)...
>

 Brain-fingers disconnect at whatever early hour I typed that.


> If you ever want to contribute anything without having to deal with
> the confusing website back end, you can email the list or me directly
> if you wish.
>

Thanks, I may do that. We'll see how much time I have to even look at the
website, before I think about changes.

Hal

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-27 Thread David Nelson
Hi Hal, Jeremy :-)

I upgraded your permissions to Publisher. When you feel your content
is ready, you can publish straight to the Web.

@Hal: a possible to-do: You worked on compiling a book of the Getting
Started Guide. I still haven't had time to post that in the docs
section at http://www.libreoffice.org/get-help/documentation/

Do you feel like doing that? I won't have much time over the next
couple of days, but could do so beginning of next week, if not.

As the guy on the team with most time spent using SilverStripe, I'll
have a look at your Mac instructions and see if I can help out with
any improvements to the formatting, and post the rest of your
screenshots.

As from next week, I plan to spend a lot more time working with you
guys on documentation.

David Nelson

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-27 Thread Michael Wheatland
On Fri, Jan 28, 2011 at 7:29 AM, Hal Parker  wrote:
> On Thu, Jan 27, 2011 at 2:40 PM, David Nelson wrote:
>
>> Hi Michael, :-)
>>
>> On Thu, Jan 27, 2011 at 12:33, Michael Wheatland
>>  wrote:
>> > As soon as someone who knows how Silverstripe works fixes this I will
>> > publish your full document.
>>
>> Maybe leave this to Hal? It's a great opportunity to get her actively
>> involved in the site content.
>>
>>
> I have modified the text and (I think) repositioned the pictures. The result
> has been submitted for publication. I assume someone with "publish"
> permission will deal with it.
>
> I'm not entirely happy with the way it came out, but I ran out of time to
> try to figure out how to deal better with the pictures. Although I looked at
> the code used on the Windows page, which is different from that used on the
> Mac page, I didn't attempt to make major changes; I'd need to do more study
> and fiddling to understand it well enough to do that. Also, I didn't add all
> the pictures I had in my document, because I didn't have time to study the
> page about uploading and dealing with pictures, and those pictures were not
> essential to the instructions. I think they are nice-to-haves for new Mac
> users.
>
> Having done this page, I don't think I will get very involved in website
> work. Learning to use Silverlight AND Alfresco AND LibreOffice itself is
> overloading my brain. ;-) So I'll concentrate my limited time and brainpower
> on the user guides and only jump into website work occasionally to help on
> specific needs.
>
> Hal
>

Published.

I am currently in the process of learning SilverSTRIPE myself.
(Silverlight is a MS product), so things can take a little time for me
to get done.
If you ever want to contribute anything without having to deal with
the confusing website back end, you can email the list or me directly
if you wish.

Thanks for the great work with the improvement,
Michael Wheatland

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-27 Thread Hal Parker
On Thu, Jan 27, 2011 at 2:40 PM, David Nelson wrote:

> Hi Michael, :-)
>
> On Thu, Jan 27, 2011 at 12:33, Michael Wheatland
>  wrote:
> > As soon as someone who knows how Silverstripe works fixes this I will
> > publish your full document.
>
> Maybe leave this to Hal? It's a great opportunity to get her actively
> involved in the site content.
>
>
I have modified the text and (I think) repositioned the pictures. The result
has been submitted for publication. I assume someone with "publish"
permission will deal with it.

I'm not entirely happy with the way it came out, but I ran out of time to
try to figure out how to deal better with the pictures. Although I looked at
the code used on the Windows page, which is different from that used on the
Mac page, I didn't attempt to make major changes; I'd need to do more study
and fiddling to understand it well enough to do that. Also, I didn't add all
the pictures I had in my document, because I didn't have time to study the
page about uploading and dealing with pictures, and those pictures were not
essential to the instructions. I think they are nice-to-haves for new Mac
users.

Having done this page, I don't think I will get very involved in website
work. Learning to use Silverlight AND Alfresco AND LibreOffice itself is
overloading my brain. ;-) So I'll concentrate my limited time and brainpower
on the user guides and only jump into website work occasionally to help on
specific needs.

Hal

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi Jeremy, :-)

On Thu, Jan 27, 2011 at 13:15, Jeremy Cartwright  wrote:
> Pardon, I meant the Why? pages sound great as a project to begin
> working on. :D The bullet points are nice, but there could be some
> fluff. I'll mull it over and submit content over the next few days.

Cool, that's really great. :-)

> I'll take a look at the Silverstripe back-end and see what I come up
> with.

Good luck, buddy. ;-)

David Nelson

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Hal Parker
On Thu, Jan 27, 2011 at 3:09 PM, David Nelson wrote:

> Hi, :-)
>
> On Thu, Jan 27, 2011 at 13:03, Michael Wheatland
>  wrote:
> > Not sure if you have noticed, but inserting images into the
> > Silverstripe TinyMCE editor is fundamentally broken.
> > I would suggest holding off on this until this is resolved by our
> > website administration brother(s) (read Christian).
>
> I've been working with it and I know the difficulties. One can fix
> things manually by hitting the HTML editor button and then manually
> editing the HTML (I do it in an external text editor personally, not
> the browser window that opens).
>
>
Thanks for the warning. I generally much prefer to work in an HTML editor,
not a WYSIWYG editor, so I'll see how I go. ;-)

Hal

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Jeremy Cartwright
On Thu, 27 Jan 2011 10:03:45 +0800
David Nelson  wrote:

> Hi Jeremy, :-)
> 
> On Thu, Jan 27, 2011 at 06:33, Jeremy Cartwright
>  wrote:
> > ok, I've registered. the Why? pages under the Home page sound great.
> 
Pardon, I meant the Why? pages sound great as a project to begin
working on. :D The bullet points are nice, but there could be some
fluff. I'll mull it over and submit content over the next few days.

I'll take a look at the Silverstripe back-end and see what I come up
with. 

-- jdc

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi, :-)

On Thu, Jan 27, 2011 at 13:03, Michael Wheatland
 wrote:
> Not sure if you have noticed, but inserting images into the
> Silverstripe TinyMCE editor is fundamentally broken.
> I would suggest holding off on this until this is resolved by our
> website administration brother(s) (read Christian).

I've been working with it and I know the difficulties. One can fix
things manually by hitting the HTML editor button and then manually
editing the HTML (I do it in an external text editor personally, not
the browser window that opens).

David Nelson

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Michael Wheatland
On Thu, Jan 27, 2011 at 2:10 PM, David Nelson  wrote:
> Hi Michael, :-)
>
> On Thu, Jan 27, 2011 at 12:33, Michael Wheatland
>  wrote:
>> As soon as someone who knows how Silverstripe works fixes this I will
>> publish your full document.
>
> Maybe leave this to Hal? It's a great opportunity to get her actively
> involved in the site content.

Not sure if you have noticed, but inserting images into the
Silverstripe TinyMCE editor is fundamentally broken.
I would suggest holding off on this until this is resolved by our
website administration brother(s) (read Christian).

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi Michael, :-)

On Thu, Jan 27, 2011 at 12:33, Michael Wheatland
 wrote:
> As soon as someone who knows how Silverstripe works fixes this I will
> publish your full document.

Maybe leave this to Hal? It's a great opportunity to get her actively
involved in the site content.

David Nelson

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Michael Wheatland
On Thu, Jan 27, 2011 at 1:55 PM, Michael Wheatland
 wrote:
> 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

The problems I am having with the Silverstripe editor is holding me
out from publishing your document fully.
As soon as someone who knows how Silverstripe works fixes this I will
publish your full document.

Sorry about the delay.

Mike

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Michael Wheatland
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


On Thu, Jan 27, 2011 at 1:10 PM, David Nelson  wrote:
> Hi Hal, :-)
>
> 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
>
> --
> Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
> List archive: http://listarchives.libreoffice.org/www/documentation/
> *** All posts to this list are publicly archived for eternity ***
>
>

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi Hal, :-)

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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Hal Parker
On Thu, Jan 27, 2011 at 11:49 AM, David Nelson wrote:

> Hi Hal, :-)
>
> 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...
>
>
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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi Jeremy, :-)

On Thu, Jan 27, 2011 at 06:33, Jeremy Cartwright  wrote:
> 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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi Hal, :-)

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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Michael Wheatland
On Thu, Jan 27, 2011 at 12:08 AM, David Nelson  wrote:
> Hi, :-)
>
> On Wed, Jan 26, 2011 at 18:45, Michael Wheatland
>  wrote:
>> 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?
>

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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Jeremy Cartwright
On Wed, 26 Jan 2011 23:19:33 +0800
David Nelson  wrote:

> 
> 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.
> 

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


-- jdc

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Hal Parker
On Thu, Jan 27, 2011 at 12:38 AM, David Nelson wrote:

> Hi, :-)
>
> On Wed, Jan 26, 2011 at 18:45, Michael Wheatland
>  wrote:
> > 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.
>


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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi, :-)

On Thu, Jan 27, 2011 at 03:22, Rogerio Luz Coelho  wrote:
> 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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Rogerio Luz Coelho
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

2011/1/26 David Nelson 

> Hi Alex, :-)
>
> On Wed, Jan 26, 2011 at 23:27, Alexander Thurgood
>  wrote:
> > 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
>
> --
> Unsubscribe instructions: E-mail to 
> documentation+h...@libreoffice.org
> List archive: http://listarchives.libreoffice.org/www/documentation/
> *** All posts to this list are publicly archived for eternity ***
>
>

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi Alex, :-)

On Wed, Jan 26, 2011 at 23:27, Alexander Thurgood
 wrote:
> 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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



[libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Alexander Thurgood
Le 26/01/11 16:13, David Nelson a écrit :
> 
> 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?

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


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi Jeremy, :-)

On Wed, Jan 26, 2011 at 23:09, Jeremy Cartwright  wrote:
> 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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi, :-)

> 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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Jeremy Cartwright
On Wed, 26 Jan 2011 22:50:33 +0800
David Nelson  wrote:

> 
> 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.
> 

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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



[libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Alexander Thurgood
Le 26/01/11 15:50, David Nelson a écrit :

> 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


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi Alex, :-)

On Wed, Jan 26, 2011 at 22:43, Alexander Thurgood
 wrote:
> 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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



[libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Alexander Thurgood
Le 26/01/11 15:38, David Nelson a écrit :

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


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi, :-)

On Wed, Jan 26, 2011 at 18:45, Michael Wheatland
 wrote:
> 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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread David Nelson
Hi Hal, Michael, :-)

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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Michael Wheatland
On Wed, Jan 26, 2011 at 7:48 PM, Hal Parker  wrote:
> On Wed, Jan 26, 2011 at 8:10 PM, Hal Parker  wrote:
>
>> On Wed, Jan 26, 2011 at 8:00 PM, Michael Wheatland <
>> mich...@wheatland.com.au> wrote:
>>
>>> On Wed, Jan 26, 2011 at 4:27 PM, Larry Gusaas 
>>> wrote:
>>> >
>>> > On 2011/01/11 9:05 PM  David Nelson wrote:
>>> >>
>>> >> Hi, :-)
>>> >>
>>> >> On Wed, Jan 12, 2011 at 08:28, Hal Parker
>>>  wrote:
>>> >>>
>>> >>> On Wed, Jan 12, 2011 at 10:06 AM, Larry
>>> >>> Gusaaswrote:
>>> >>>
>>>  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. ;-)
>>> >
>>> > Two weeks later and the terminology is still incorrect.
>>> >
>>> > Larry
>>>
>>>
>>> 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.
>>>
>>>
>>> Michael, I revised (completely rewrote) the document with screenshots some
>> 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. ;-)
>>
>> Hal
>>
>>
> I have now put the file (mac-install.odt) in the "Various" section under
> "LibreOffice Docs" on the Alfresco site.
>
>

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

Thanks
Mike

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Hal Parker
On Wed, Jan 26, 2011 at 8:10 PM, Hal Parker  wrote:

> On Wed, Jan 26, 2011 at 8:00 PM, Michael Wheatland <
> mich...@wheatland.com.au> wrote:
>
>> On Wed, Jan 26, 2011 at 4:27 PM, Larry Gusaas 
>> wrote:
>> >
>> > On 2011/01/11 9:05 PM  David Nelson wrote:
>> >>
>> >> Hi, :-)
>> >>
>> >> On Wed, Jan 12, 2011 at 08:28, Hal Parker
>>  wrote:
>> >>>
>> >>> On Wed, Jan 12, 2011 at 10:06 AM, Larry
>> >>> Gusaaswrote:
>> >>>
>>  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. ;-)
>> >
>> > Two weeks later and the terminology is still incorrect.
>> >
>> > Larry
>>
>>
>> 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.
>>
>>
>> Michael, I revised (completely rewrote) the document with screenshots some
> 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. ;-)
>
> Hal
>
>
I have now put the file (mac-install.odt) in the "Various" section under
"LibreOffice Docs" on the Alfresco site.

Hal

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Hal Parker
On Wed, Jan 26, 2011 at 8:00 PM, Michael Wheatland  wrote:

> On Wed, Jan 26, 2011 at 4:27 PM, Larry Gusaas 
> wrote:
> >
> > On 2011/01/11 9:05 PM  David Nelson wrote:
> >>
> >> Hi, :-)
> >>
> >> On Wed, Jan 12, 2011 at 08:28, Hal Parker
>  wrote:
> >>>
> >>> On Wed, Jan 12, 2011 at 10:06 AM, Larry
> >>> Gusaaswrote:
> >>>
>  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. ;-)
> >
> > Two weeks later and the terminology is still incorrect.
> >
> > Larry
>
>
> 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.
>
>
> Michael, I revised (completely rewrote) the document with screenshots some
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. ;-)

Hal

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-26 Thread Michael Wheatland
On Wed, Jan 26, 2011 at 4:27 PM, Larry Gusaas  wrote:
>
> On 2011/01/11 9:05 PM  David Nelson wrote:
>>
>> Hi, :-)
>>
>> On Wed, Jan 12, 2011 at 08:28, Hal Parker  wrote:
>>>
>>> On Wed, Jan 12, 2011 at 10:06 AM, Larry
>>> Gusaaswrote:
>>>
 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. ;-)
>
> Two weeks later and the terminology is still incorrect.
>
> Larry


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

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


[libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-25 Thread Larry Gusaas


On 2011/01/11 9:05 PM  David Nelson wrote:

Hi, :-)

On Wed, Jan 12, 2011 at 08:28, Hal Parker  wrote:

On Wed, Jan 12, 2011 at 10:06 AM, Larry Gusaaswrote:


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. ;-)


Two weeks later and the terminology is still incorrect.

Larry
--
_
Larry I. Gusaas
Moose Jaw, Saskatchewan Canada
Website: http://larry-gusaas.com
"An artist is never ahead of his time but most people are far behind theirs." - 
Edgard Varese



--
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-16 Thread David Nelson
Hi Rachel, :-)

OK, thanks for your help, and welcome to the team. We'll get a set of
documents set up for you on Alfresco so that you can get started when
you're ready. Meanwhile I set up an account for you (I'll mail you the
details), and I will send you a some Alfresco documentation.

So I'll be posting back with further info in a couple of days...

David Nelson

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-16 Thread rachel a kartch
Hi David:

Yes, please set up an account for me.  I'm interested in seeing Alfresco 
anyway, and I see no reason for me to make up my own workflow if you already 
have something you're trying to implement.

Rachel

>-Original Message-
>From: David Nelson [mailto:comme...@traduction.biz]
>Sent: Saturday, January 15, 2011 12:04 PM
>To: documentation@libreoffice.org
>Subject: Re: [libreoffice-documentation] Re: Incorrect Terminology for 
>Installing on a Mac
>
>Hi Rachel, :-)
>
>On Sat, Jan 15, 2011 at 23:52, rachel a kartch  wrote:
>> If someone would like me to scrub some docs similarly for LibreOffice, I 
>> would be happy to help out.  Unfortunately I'm short on time these days so 
>> I'm not able right now to produce full documentation, but I could try to go 
>> through docs already created and note the Mac-specific differences.
>
>This would be valuable work if you would be willing to do it. If
>you're willing to do this via the special documentation site we're
>currently developing and trying out, I can set you up an account
>there, and organize docs for you to review, and we can guide you
>through the content we currently have ready. But you are not obliged
>to do things that way if you don't want to.
>
>That site is at https://documentation.traduction.biz
>
>Do you want an account?
>
>Otherwise, in any case, Ron Faile would be a perfect liaison person
>for you, unless someone else feels like giving you a helping hand...
>Or me if no-one else steps up...
>
>David Nelson
>
>-- 
>Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
>List archive: http://listarchives.libreoffice.org/www/documentation/
>*** All posts to this list are publicly archived for eternity ***
>
>



-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-15 Thread David Nelson
Hi Rachel, :-)

On Sat, Jan 15, 2011 at 23:52, rachel a kartch  wrote:
> If someone would like me to scrub some docs similarly for LibreOffice, I 
> would be happy to help out.  Unfortunately I'm short on time these days so 
> I'm not able right now to produce full documentation, but I could try to go 
> through docs already created and note the Mac-specific differences.

This would be valuable work if you would be willing to do it. If
you're willing to do this via the special documentation site we're
currently developing and trying out, I can set you up an account
there, and organize docs for you to review, and we can guide you
through the content we currently have ready. But you are not obliged
to do things that way if you don't want to.

That site is at https://documentation.traduction.biz

Do you want an account?

Otherwise, in any case, Ron Faile would be a perfect liaison person
for you, unless someone else feels like giving you a helping hand...
Or me if no-one else steps up...

David Nelson

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-15 Thread rachel a kartch
Hi all--

I've been lurking on this list for a while, as a sometime-contributor to 
OpenOffice documentation who had hoped eventually to get involved here as well. 
 I'm the Mac user Jean referenced who pointed out problems in the OOo 
documentation and provided correct Mac menu paths and keystrokes.

If someone would like me to scrub some docs similarly for LibreOffice, I would 
be happy to help out.  Unfortunately I'm short on time these days so I'm not 
able right now to produce full documentation, but I could try to go through 
docs already created and note the Mac-specific differences.

If that would be at all helpful or needed, please let me know.


Rachel

>-Original Message-
>From: Rogerio Luz Coelho [mailto:luz.roge...@gmail.com]
>Sent: Saturday, January 15, 2011 09:33 AM
>To: documentation@libreoffice.org
>Subject: Re: [libreoffice-documentation] Re: Incorrect Terminology for 
>Installing on a Mac
>
>Summarizing this thread:
>
>Mac Documentation needs attention, but Mac Developers are still rare, so we
>will have to wait a bit to get this done.
>
>If someone with a Mac could step up we would appreciate it ...
>
>Thanks,
>
>Rogerio
>
>-- 
>Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
>List archive: http://listarchives.libreoffice.org/www/documentation/
>*** All posts to this list are publicly archived for eternity ***
>
>



-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-15 Thread Rogerio Luz Coelho
Summarizing this thread:

Mac Documentation needs attention, but Mac Developers are still rare, so we
will have to wait a bit to get this done.

If someone with a Mac could step up we would appreciate it ...

Thanks,

Rogerio

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



[libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-13 Thread Larry Gusaas

On 2011/01/12 11:26 PM  David Nelson wrote:

You may find things like smilies to be superfluous


Adding a smiley does not change the fact that a statement is condescending or insulting. I will 
respond in kind.


Larry
--
_
Larry I. Gusaas
Moose Jaw, Saskatchewan Canada
Website: http://larry-gusaas.com
"An artist is never ahead of his time but most people are far behind theirs." - 
Edgard Varese



--
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-13 Thread Fabián Rodríguez
On 11-01-13 12:24 AM, Larry Gusaas wrote:
>
> [..]
>> So, if you don't like
>> something, start *doing* something about it. ;-)
>
> I'll do something. I won't put up with your abusive bullshit.
>> David Nelson
> Larry

Hi Larry,

Thank you for your comments. They are a good reminder 90% accuracy in
documentation is not good enough, despite all the efforts we may put in
it. I know your choice of words may not seem ideal to many but we need
to see further. I hope you stick around.

Perhaps a more constructive approach would be to have some sort of
warning about the Mac documentation needing help, being draft or else ?
I know how this sounds, but a clear link to the bug reporting section or
1-2-3 steps (even easier, lower barrier than this list) to reporting
such errors would quickly constitue a to-do list than even a non-Mac
user can tackle easily. Some of us could relay such issues as bugs -
would it be appropriate to do so ? Which component ? "Documentation"
indicates it's for "Problems with online help". There's also this part
of the docs wiki:
http://wiki.documentfoundation.org/Documentation/Produce

I tend to agree with Larry it's on use to get more Mac users (and
ultimately, convert them to another OS... but that's another subject !).
80% of that goal starts by reporting the problems, which is a huge
contribution IMHO.

Cheers,

Fabian

--
LibreOffice questions ? Des questions sur LibreOffice ? Preguntas acerca
de LibreOffice ? Ask LibreOffice: http://libreoffice.shapado.com/
~
Fabián Rodríguez
http://wiki.documentfoundation.org/User:MagicFab


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


[libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread Larry Gusaas


On 2011/01/12 9:55 PM  David Nelson wrote:

Hi Larry, :-)

On Thu, Jan 13, 2011 at 11:24, Larry Gusaas  wrote:

I get real tired, smiley or no smiley of being told to do it myself when
making suggestions to open source projects.

People who work on Open Source projects sometimes get tired of being
told how to do their work by people who aren't willing to contribute
work.


Making suggestions and pointing out errors is contributing to the project. The project isn't 
about you, it is for the people who will use the product. Time you started listening.



After all, you're not paying us, right?


Too bad. If I was, you would be fired.


So, if you don't like
something, start *doing* something about it. ;-)


I'll do something. I won't put up with your abusive bullshit.


David Nelson



Larry
--
_
Larry I. Gusaas
Moose Jaw, Saskatchewan Canada
Website: http://larry-gusaas.com
"An artist is never ahead of his time but most people are far behind theirs." - 
Edgard Varese



--
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread David Nelson
Hi Hal, :-)

Sorry, Hal, I don't agree with you. I only invited Larry in the
friendliest way to get involved in remedying shortcomings with regard
to Mac info in LibreOffice documentation.

Larry replied, "Whenever I notice something that is incorrect I will
let you know. The real question is do you want Mac users to use
LibreOffice? If so, you will provide correct documentation. I get real
tired, smiley or no smiley of being told to do it myself when making
suggestions to open source projects."

Personally, I found the tone, and the manner of interpreting what I
actually said, to be less than gracious, friendly and recognizing of
the time and work I and others contribute to providing Open Source to
the world. I am not there to be spoken to harshly by Larry or anyone
else. I, myself, always strive to be courteous and friendly to people.

BTW, I am not the first to have said something similar to Larry in
recent threads on TDF lists. So, Larry, might I invite you to perhaps
adjust the *tone* of your communications a little bit.

You may find things like smilies to be superfluous, but little touches
like that, plus old-fashioned terms and phrases like "Please, could
you consider..." and "Thank you for your work..." are like a
lubricating oil that makes human relations take place in a
more-gracious and friendlier manner. ;-)

The point I made was a perfectly valid one: the best way to ensure
constant improvement in Open Source is to get in there and help out.
At the very least, when "making suggestions", it would be good to make
them in a tone that sounds a bit less grumpy and unpleasant. ;-)

So, to tell you again: sorry, Hal, I do not agree with you.

But I'm not getting into an argument about this, so I will allow you
and/or others the satisfaction of having the last word on the subject.
;-)

I'm sure you'll have a good time at my expense! :-D

David Nelson

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread Hal Parker
On Thu, Jan 13, 2011 at 1:55 PM, David Nelson wrote:

> Hi Larry, :-)
>
> On Thu, Jan 13, 2011 at 11:24, Larry Gusaas 
> wrote:
> > I get real tired, smiley or no smiley of being told to do it myself when
> > making suggestions to open source projects.
>
> People who work on Open Source projects sometimes get tired of being
> told how to do their work by people who aren't willing to contribute
> work. After all, you're not paying us, right? So, if you don't like
> something, start *doing* something about it. ;-)
>
>
David, I think your comment to Larry in this note was inappropriate and
uncalled for. Pointing out errors is not, in my view, telling someone how to
do their work. Nor is suggestions on how things could be done better.

I'm with Jean: I appreciate it anytime someone points out something that I
didn't know, but which is info that I can use to improve something I'm
working on. While it would, of course, be nice for everyone who sees a
problem to help solve that problem, I don't expect or require that of
anyone. I am just grateful to be made aware of the problem. Unless, of
course, someone makes me aware in an argumentative way... which Larry did
not do.

Hal

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread Jean Hollis Weber
On Wed, 2011-01-12 at 21:24 -0600, Larry Gusaas wrote:
> On 2011/01/12 8:52 PM  David Nelson wrote:
> > At that time, we'd need some Mac users on the team to get involved and
> > help us provide content that is OK for the Mac community... You could,
> > for instance, post-edit drafted documentation and augment it with
> > Mac-related content (shortcut tables, etc.).
> 
> Whenever I notice something that is incorrect I will let you know.
> 
> > If you want Mac-ready content, then the answer is to get in there and
> > give us a hand!:-D
> 
> The real question is do you want Mac users to use LibreOffice? If so, you 
> will provide correct 
> documentation.
> 
> I get real tired, smiley or no smiley of being told to do it myself when 
> making suggestions to 
> open source projects.

Larry,
I know that feeling only too well. And I, for one, always tell people
(and mean it) that just letting me know about problems is very welcome.
So feel free to contact me directly, and I'll do my best to get fixes
into both the OOo docs and the LibO docs.

I'm particularly interested in the Mac issues because I got my first Mac
a few weeks ago and am slowly getting used to the differences. It joins
my main machine (Ubuntu) and my secondary machine (Windows). I hope that
using will help me improve the OOo/LibO docs, in addition to the things
I got it for.

Regards, Jean


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread David Nelson
Hi Larry, :-)

On Thu, Jan 13, 2011 at 11:24, Larry Gusaas  wrote:
> I get real tired, smiley or no smiley of being told to do it myself when
> making suggestions to open source projects.

People who work on Open Source projects sometimes get tired of being
told how to do their work by people who aren't willing to contribute
work. After all, you're not paying us, right? So, if you don't like
something, start *doing* something about it. ;-)

David Nelson

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



[libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread Larry Gusaas


On 2011/01/12 8:52 PM  David Nelson wrote:

At that time, we'd need some Mac users on the team to get involved and
help us provide content that is OK for the Mac community... You could,
for instance, post-edit drafted documentation and augment it with
Mac-related content (shortcut tables, etc.).


Whenever I notice something that is incorrect I will let you know.


If you want Mac-ready content, then the answer is to get in there and
give us a hand!:-D


The real question is do you want Mac users to use LibreOffice? If so, you will provide correct 
documentation.


I get real tired, smiley or no smiley of being told to do it myself when making suggestions to 
open source projects.


Larry
--
_
Larry I. Gusaas
Moose Jaw, Saskatchewan Canada
Website: http://larry-gusaas.com
"An artist is never ahead of his time but most people are far behind theirs." - 
Edgard Varese



--
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread David Nelson
Hi Larry, :-)

Unfortunately, we just don't have enough active team members, at the
moment, to develop platform-specific documentation.

Right now, documentation is being sourced from oooauthors.org and
adapted to the LibreOffice team's needs for LibreOffice. So, if that
oooauthors.org content contains Mac-specific info, it will be
preserved.

But, IMHO, when the LibreOffice team has its own dedicated working
resources, and when the OOo/LibO disributions start to diverge, and
when the LibreOffice team starts work on the manuals that are
currently completely unwritten, I'd guess we'll be developing our own
documentation independently. I'd guess that this will happen in the
fairly near future...

At that time, we'd need some Mac users on the team to get involved and
help us provide content that is OK for the Mac community... You could,
for instance, post-edit drafted documentation and augment it with
Mac-related content (shortcut tables, etc.).

If you want Mac-ready content, then the answer is to get in there and
give us a hand! :-D

David Nelson

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread Jean Hollis Weber
On Wed, 2011-01-12 at 19:12 -0600, Larry Gusaas wrote:
> On 2011/01/12 6:49 AM  Alexander Thurgood wrote:
> > I agree, however, that completely rewriting the documentation / guides,
> > etc, just to take into account the specificities of Mac vocabulary is
> > not a route that I am going to go down. If Larry wants to make Mac
> > specific guides just for that platform then he is quite welcome to do so
> > as far as I'm concerned :-))
> 
> I am not and am not about to become a documentation writer. However, it is 
> very important to 
> have correct terminology for users learning a program.
> 
> I have lost count of the number of times Mac users on help forums have stated 
> they can not find 
> "Tools/Options" after being referred to that setting by a user guide or help 
> file (or a non Mac 
> user trying to give support). The correct location is 
> "OpenOffice.org/Preferences". An 
> experienced Mac user will probably figure it out for themselves since that is 
> the usual 
> location for preference settings on a Mac. But a new Mac user will not know 
> that.


The OOo docs team are putting the common Mac menu and keystroke
differences in a table in every chapter of the OOo user guides, and I
believe the LibO docs team are keeping those tables. We (the OOo team)
will expand those lists as needed, if someone who uses a Mac brings the
differences to our attention. It may not be an ideal solution, but I
believe it is a definite improvement.

The inclusion of the Mac menu/keystroke info came about because someone
finally joined the team who (a) is a Mac user and (b) specifically
mentioned these issues. I at least am very happy this occurred. 

--Jean


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


[libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread Larry Gusaas


On 2011/01/12 6:49 AM  Alexander Thurgood wrote:

I agree, however, that completely rewriting the documentation / guides,
etc, just to take into account the specificities of Mac vocabulary is
not a route that I am going to go down. If Larry wants to make Mac
specific guides just for that platform then he is quite welcome to do so
as far as I'm concerned :-))


I am not and am not about to become a documentation writer. However, it is very important to 
have correct terminology for users learning a program.


I have lost count of the number of times Mac users on help forums have stated they can not find 
"Tools/Options" after being referred to that setting by a user guide or help file (or a non Mac 
user trying to give support). The correct location is "OpenOffice.org/Preferences". An 
experienced Mac user will probably figure it out for themselves since that is the usual 
location for preference settings on a Mac. But a new Mac user will not know that.


Many people are switching to Macs. Many of them may try LibreOffice. However, if the 
documentation is inaccurate, they will be unlikely to continue using it.


Larry
--
_
Larry I. Gusaas
Moose Jaw, Saskatchewan Canada
Website: http://larry-gusaas.com
"An artist is never ahead of his time but most people are far behind theirs." - 
Edgard Varese



--
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread Tom Davies
Ahh, good good :)

I think they were talking about specifically Mac documentation.  So, i 
completely reverse my previous comment about this (fwiw) and now agree with 
using dock or whatever is correct rather than trying to use Windows terms.  


Many apologies for my previous post Larry!

Many regards to all from
Tom :)







From: Alexander Thurgood 
To: documentation@libreoffice.org
Sent: Wed, 12 January, 2011 12:49:13
Subject: [libreoffice-documentation] Re: Incorrect Terminology for Installing 
on 
a Mac

Le 12/01/11 10:24, Tom Davies a écrit :

Hi Tom,

As far as the Mac goes, Larry is right. The vocabulary is pretty
specific, and people on Mac don't generally refer to Taskbar, Drawer,
etc. Ever since OSX came into being, the UI has remained essentially
unchanged, so those specific terms are all understood by Mac users.

I agree, however, that completely rewriting the documentation / guides,
etc, just to take into account the specificities of Mac vocabulary is
not a route that I am going to go down. If Larry wants to make Mac
specific guides just for that platform then he is quite welcome to do so
as far as I'm concerned :-))


Alex


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



  
-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



[libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread Alexander Thurgood
Le 12/01/11 10:24, Tom Davies a écrit :

Hi Tom,

As far as the Mac goes, Larry is right. The vocabulary is pretty
specific, and people on Mac don't generally refer to Taskbar, Drawer,
etc. Ever since OSX came into being, the UI has remained essentially
unchanged, so those specific terms are all understood by Mac users.

I agree, however, that completely rewriting the documentation / guides,
etc, just to take into account the specificities of Mac vocabulary is
not a route that I am going to go down. If Larry wants to make Mac
specific guides just for that platform then he is quite welcome to do so
as far as I'm concerned :-))


Alex


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


Re: [libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread Tom Davies
Hi :)

Is there a generic term that covers taskbar, dock, panel?  Many users will see 
all these things as being very much alike.  Geeks know that they are completely 
different of course but many people don't even know the name for whichever one 
they have been using for years.  I think taskbar is generally used as the 
generic term since docks are almost never seen by about 90-80% of desktop users.

Regards from
Tom :)






From: Alexander Thurgood 
To: documentation@libreoffice.org
Sent: Wed, 12 January, 2011 8:49:41
Subject: [libreoffice-documentation] Re: Incorrect Terminology for Installing 
on 
a Mac

Le 12/01/11 01:06, Larry Gusaas a écrit :

Hi Larry,

> 
> 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.


That would be my bad, since I initially wrote down the installation
instructions in a hurried mail which took me about 30 seconds, and I am
a Linux / Unix-er at heart with Enlightenment / XFCE desktop preferences
and experience, so my Mac terminology is sub-optimal, shall we say :-)
Thanks for correcting this.

Alex


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***



  
-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***


[libreoffice-documentation] Re: Incorrect Terminology for Installing on a Mac

2011-01-12 Thread Alexander Thurgood
Le 12/01/11 01:06, Larry Gusaas a écrit :

Hi Larry,

> 
> 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.


That would be my bad, since I initially wrote down the installation
instructions in a hurried mail which took me about 30 seconds, and I am
a Linux / Unix-er at heart with Enlightenment / XFCE desktop preferences
and experience, so my Mac terminology is sub-optimal, shall we say :-)
Thanks for correcting this.

Alex


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***