wanting clarification on how to start submitting(?) updates to docs

after a quick perusal of the last few days of posts on this list, i
just want to make sure i'm starting off the right way in reviewing the
current docs and noting content that could be updated.

  as i read it, with my brand new alfresco account, i can go here:

  http://alfresco.libreoffice.org/

log in, then go to

  Company Home -> English Content -> Documentation

and select, say, the "Getting Started Guide." i can see that the
various chapters of that guide are individual .odt files so once i got
confident, i could check one out, make changes, then check it back in
(not prepared to do that just yet).

  for example, say i was perusing the "SettingUpLibreOffice" chapter,
where i notice a couple of things:

  * a couple references to "LibraOffice" rather than "LibreOffice",
which i assume are simple typoes

  * there's also a reference to the "Help formatting" option
(allegedly under LibreOffice->General) which i simply don't see in my
3.4.1 writer session.

  is that the sort of thing that one starts off doing -- just some
simple fixes? or have i misread something? thanks.

rday

p.s. i also see a reference to "Enable systray quickstarter on Linux"
but i don't see that anywhere in my linux session. perhaps i just
didn't look hard enough.

Certainly if you see errors, either typos or factual errors, correcting
them is a good thing. Check out, make changes (with changing tracking
on), check back in... as you said.

However, be aware that if you're using 3.4.1 you will definitely see
some differences from what is in the book for 3.2/3.3. "Enable systray
Quickstarter" appears to be one of them; at least, I see it in 3.3.3 but
not in 3.4.1. If you update a chapter for 3.4.1, you should just
download it (but not check it out) and then put it into Drafts when you
are done.

Other items may be operating system specific. We try to note those in
the books, but sometimes miss them. And other discrepancies may just be
errors: things that were in OOo but are not in LO and didn't get deleted
when the books were rebranded. Those are certainly good to spot and deal
with.

At this time we are trying to finish a full set of books for 3.3,
because some people will be using that for awhile yet. The Impress Guide
in particular needs help! It's been "rebranded" from OOo to LO, but most
of the chapters have not yet been checked to see if they are correct for
LO3.3. I know there are some differences between OOo and LO Impress, but
I don't recall what they are. Also, Impress is different in 3.4.1 from
3.3, so that book will need updating to 3.4.1 at some point.

Draw Guide is also being worked on, but Martin Fox is doing the updates
and others are doing the screenshots, so that is less urgent than the
Impress Guide.

If anyone starts updating to 3.4.x, the files should be renamed in some
way so we don't get the 3.3.x chapters and the 3.4.x chapters mixed up.
In some cases, the differences will be trivial or minor and might best
be accommodated by a simple note or flag in a single chapters. We
haven't talked about updating yet and how to best handle minor vs major
changes in the program. One potentially awkward area is screenshots,
when the functions haven't changed (or not much) but the visual
appearance has.

Er... that was a somewhat roundabout answer, wasn't it? I hope it WAS an
answer and not just a lead-in to more questions.

--Jean

Hi :slight_smile:
Yes, at some point the Documentation Team are going to need to have at least 2
separate sets of Documentation = 1 for stable branch (3.3.x) and one for "early
adopters" (development/cooking) branch. Hopefully there is going to be some
neat trick that makes that easier. Within the 3.3.x branch the 3.3.0, 3.3.1 and
3.3.2 have 1 year's support. However, lets not worry about that until after the
3.3.3 documentation is complete.
Regards from
Tom :slight_smile:

Hi Robert,

after a quick perusal of the last few days of posts on this list, i
just want to make sure i'm starting off the right way in reviewing the
current docs and noting content that could be updated.

as i read it, with my brand new alfresco account, i can go here:

http://alfresco.libreoffice.org/

log in, then go to

Company Home -> English Content -> Documentation

and select, say, the "Getting Started Guide."  i can see that the
various chapters of that guide are individual .odt files so once i got
confident, i could check one out, make changes, then check it back in
(not prepared to do that just yet).

Yes, that's the way.

for example, say i was perusing the "SettingUpLibreOffice" chapter,
where i notice a couple of things:

* a couple references to "LibraOffice" rather than "LibreOffice",
which i assume are simple typoes

Yes, quite right.

* there's also a reference to the "Help formatting" option
(allegedly under LibreOffice->General) which i simply don't see in my
3.4.1 writer session.

Jean already commented on possible differences between versions, so I
don't need to add more.

is that the sort of thing that one starts off doing -- just some
simple fixes?  or have i misread something?  thanks.

Yes, this is already very useful contribution and a great way to get
started. Again, Jean already said things in reply to you, but
basically you're on the right track.

p.s.  i also see a reference to "Enable systray quickstarter on Linux"
but i don't see that anywhere in my linux session.  perhaps i just
didn't look hard enough.

What Linux are you using? If you're on Ubuntu 11.04, the quickstarter
is not currently functioning under Unity. But, in any case, the
quickstarter needs to be activated first (Tools > Options >
LibreOffice > Memory > Enable systray QuickStarter) and then you need
to log-out and log back in to your session (or simply restart your
system). Only after that would you see it in the systray.

Any problems or questions you have with Alfresco, don't hesitate to
ask and I'll answer as quickly as possible.

A big thanks for working on docs. :slight_smile:

In 3.3.3 "Enable systray QuickStarter" appears in the options where
you say, but (at least on my copy of 3.4.1) it is not there. This
probably explains why Robert can't find it in 3.4.1.

--Jean

ubuntu 11.04, running ubuntu classic (not unity), and i see no such
setting under the "Memory" submenu. is the visibility of that setting
dependent on some other selection? can someone else verify that they
can see that option in LO 3.4.1?

rday

Hi Robert,

In 3.3.3 "Enable systray QuickStarter" appears in the options where
you say, but (at least on my copy of 3.4.1) it is not there. This
probably explains why Robert can't find it in 3.4.1.

Jean just pointed out that this feature is not there in 3.4.1. Myself,
I prefer to stick with the version of LibreOffice currently being
distributed by Ubuntu, so I've still got 3.3.2 for the moment - I'm
sure Ubuntu will be pushing out the new version of LibreOffice
sometime in the very near future.

So the new location of the "Enable systray QuickStarter" check box is
something that will require updating at a point in the future, since
it appears to have changed.

OT: In any case, my experience with 10.04 and 11.04 is that the
QuickStarter is not functioning properly at the present time in
Ubuntu: when it is present in memory, you will be unable to restart
your system or - IIRC - log out of your session.