On 12/3/2010 1:15 AM, Jean Hollis Weber wrote:
On Fri, 2010-12-03 at 00:47 -0600, Ron Faile wrote:
On 12/3/2010 12:21 AM, Jean Hollis Weber wrote:
On Thu, 2010-12-02 at 23:38 -0600, Ron Faile wrote:
On 11/30/2010 3:58 PM, Larry Gusaas wrote:
On 2010/11/23 4:37 PM  Ron Faile wrote:
I've uploaded a new version of the Getting Started with LibreOffice
Guide. Let me know if you have any comments.
The following is wrong on Mac OS X:

     *Starting LibreOffice*
     Note for Mac users You should see the LibreOffice icon in the
Applications folder. When you
     double-click on this icon, a text document opens in Writer. To open
one of the other
     LibreOffice components (Draw, Calc, Impress, Base), go to the File
menu of the Writer
     window and select the component you want.

On Macs it opens in the start centre, not in Writer. Older versions of
OOo did that but it was changed quite a while ago.


Thanks for the correction. I've updated the file.

Ron, there are copies of the LibO docs on both the LibO site and the
OOoAuthors site, and it's not clear whether the latest iteration of a
file is on the OOoAuthors site and if so, where it is located. (I am
assuming the files on the LibO site are the latest; is that correct?)

For example, there are a lot of Getting Started files on the Review List
at OOoAuthors, so a potential contributor (who is familiar with
OOoAuthors) would expect that those are the latest iterations awaiting
further review or editing. But when looking in the Feedback section for
LibO Getting Started on the OOoAuthors site, I find quite a few files
with more recent dates than those on the Review List. This suggests to
me that when files are updated, the previous version is not being
removed from the Review List and the newer version added to it. And it's
not clear to me whether the files in Feedback are the latest either.

I found similar issues with the Writer Guide files. Thus there is much
room for confusion and potential wasted effort.

If the LibO team is going to use the OOoAuthors website for tracking
docs, then I strongly suggest that it be used properly.

If the LibO team is not going to use the OOoAuthors website for this
purpose, then two things should be done:
(a) the existing files should be deleted from the OOoAuthors site, so
they don't mislead people.
(b) some other tracking method should be implemented (through the LibO
wiki), so potential contributors to LibO docs know what stage various
chapters have reached and whether those chapters are being worked on.

I have been talking to someone who is interested in helping out but
dismayed by the situation described above. And I was considering
updating some of the files with changes I made recently to the OOo docs
(correcting errors, clarifying info, adding missing info), but I did not
know which files I should use.

--Jean


All the latest files are in the feedback folder in OOoAuthors. I didn't
know about the review list feature. So they all should be removed except
the ones in feedback. I have been updating both sites with the latest
files, so both are up to date.

Ron, thanks for that info. However, not all the chapters are in
Feedback. Does that mean you are working on them and other people should
avoid working on them until you put them into Feedback? If you're not
actively working on them, are the ones in Drafts the latest, if no copy
is in Feedback?

To use the tracking system effectively, the latest files (that you have
amended) should be put on the Review List so others know they are
available for further review/editing. I have just done this for the ones
that are in Feedback.

This wiki page describes the process we use at OOoAuthors. The most
relevant bits are "How to retract a document" and "How to submit a
document", which describe what they are for and when and how to use
them.
http://wiki.services.openoffice.org/wiki/Documentation/Dashboard/Introducing_OOoAuthors#Using_the_OOoAuthors_website

--Jean


That's right. For the ones not in feedback, I'm not working on them (the latest ones are in drafts). I will read up on it. Thanks.

Ron

--
Unsubscribe instructions: E-mail to [email protected]
List archive: http://www.libreoffice.org/lists/documentation/
*** All posts to this list are publicly archived for eternity ***

Reply via email to