Is anyone working on Draw Guide

I don't think anyone is working on rebranding the Draw Guide for LibO,
changing screenshots as needed, editing, etc.

I don't recall if I mentioned on this list that the first five chapters
of the Draw Guide that are on Alfresco have been updated for OOo by
Martin Fox, who also checked them against LibO. Martin is working on the
other chapters and I will replace the files currently in the Draw Guide
space on Alfresco as they become available... unless you get to the
current versions of Chapters 6-10 first and want to do the review and
update yourself.

--Jean

Hi Jean

I will do this.

How do you check files out. It does not seem obvious to me

Regards

John

In the Content Items area under English > Documentation > Draw Guide >
Drafts, you should see a row of icons under the name and other info
about each file. Click the little arrow icon on the right-hand end of
this row of icons. One of the choices is Check Out. Click that, then
follow the prompts.

(There are other ways to get to this, but that's the method I use.)

The checkout process creates a working copy which should appear in the
same Content Items area. When you want to check a file back in, you will
find the Check In icon on the right-hand end of the row of icons
underneath the working copy.

Aside: I was going to refer you to the early-draft chapter on using
LibreOffice's Alfresco site that is in the Resources space, but it
doesn't seem to cover checkout very clearly. (I did a very hasty job on
the draft before going away in early June.)

--Jean

Hi Jean

Can't find the icons anywhere on screen. Have downloaded file will work on it and upload when finished.

Sorry to be a pain.

Regards

John

John, you are not a pain. We documentation people are in the service and product industry. It takes us very little time and effort to assist you.

It is good for you to have ideas and offer advice and such. Besides, you are doing something.

Gary

Good move, and thanks for continuing despite this problem.

Other people have had problems, too, so it's probably worth
troubleshooting this. I would like to improve the instructions if we
can figure out why they don't lead you (and others) to the icons.

I suspect that you are looking at a different view. Alfresco has many
choices. This make giving clear instructions more difficult.

When you want a break from working on the Draw Guide, please take a
screen capture of what you see when you are at a screen from which you
are downloading the file. Either send the screen capture to me offlist
or upload it somewhere and send me (or the list) the link.

--Jean

Hi John,

Hi Jean

Can't find the icons anywhere on screen.  Have downloaded file will work on
it and upload when finished.

Sorry to be a pain.

You are not at all a pain. If you don't manage to check in your docs,
please do feel free to mail them to me and I'll check them in for you,
with notes that it was your work.

We'll shortly have the workflow sorted out on Alfresco.

Hi

Thanks Jean, David and Gary for you help.

It may be right, that I am looking at a different view. I thought that Alfresco had been upgraded because suddenly it looked different. I will email a screenshot.

Regards

John

Hi John,

Thanks Jean, David and Gary for you help.

You're welcome.

It may be right, that I am looking at a different view.  I thought that
Alfresco had been upgraded because suddenly it looked different.  I will
email a screenshot.

You might take account of the fact that we have *one* Alfresco
platform but *two* possible interfaces for using it.

http://alfresco.libreoffice.org is the Alfresco Explorer interface.
This is what the Alfresco project considers to be the "old" interface.

http://documentation.libreoffice.org is the Alfresco Share interface.
This is what Alfresco considers to be the "new" interface, and they
are doing all their development work on it these days. It has a lot
more Javascript (Ajax) in it, but a lot of people would probably
consider it to be "sexier".

Maybe you guys would like to check them both out and tell me which you
prefer? Jean, for instance, likes the Alfresco Share interface.

From the screenshot you sent me offlist, I can see the source of our
miscommunication. You are using alfresco from
documentation.libreoffice.org while I am using it from
alfresco.libreoffice.org. The views are indeed very different.

The view you are using appears to not have the Checkout option among the
icons found when you hover over the file in the list. I think David may
have explained the differences between the two sites, but I've forgotten
just what they are... so I'd best not speculate lest I confuse the
situation further.

--Jean

If you need any assistance going forward with your XHTML conversions of the user guides, let me know. I occasionally edit some material through the W3C CSS email lists or through Bert Bos--the main CSS editor, catching occasional copyediting errors in the proposed new W3C CSS recommendations. Or, if you give up, then that is OK with me...

Gary

Hi John, Jean,

From the screenshot you sent me offlist, I can see the source of our
miscommunication. You are using alfresco from
documentation.libreoffice.org while I am using it from
alfresco.libreoffice.org. The views are indeed very different.

The view you are using appears to not have the Checkout option among the
icons found when you hover over the file in the list. I think David may
have explained the differences between the two sites, but I've forgotten
just what they are... so I'd best not speculate lest I confuse the
situation further.

Ah, OK. When you're using the Alfresco Share interface (at
http://documentation.libreoffice.org therefore), you go to the space
containing the document you want to "check out" (edit offline). Hover
your mouse over the document and you will see a menu appear to the
right of the document name. Click on the "More..." item and a further
menu opens. Click on "Edit Offline" and you'll be prompted to download
a working copy of the document.

Beware! You will have been whisked away from the space you were
previously in, and will have been taken to a space called "Documents
I'm Editing (working copies)". If you want to return to the space you
were previously in, you can use the "Repository" tree structure of
folders (spaces) on the left-hand side and get back there in probably
one click.

To "check in" the working copy you've edited, you would return to the
document's space (or your "Documents I'm Editing" space), hover your
mouse over the document, and click on "Upload New Version".

We'll get this properly documented very, very soon.

Hi Jean

I have uploaded the chapter Introducing Draw. I think I have changed the Branding to LibO. I haven't changed the screenshots yet as I need to download Linux to do this.

If you get a moment can you look through it and see if this is correct.

Thanks for all your help.

Regards

John

OK, will do. A quick look shows a few things that you probably wouldn't
have known about, which I can fix quickly. (I'll list them for you after
I've gone through the chapter more carefully.) Also, I have a few minor
editorial changes that came out of working this week on the OOo Draw
Guide, so I'll make them too.

I also have quite a few LibO Draw screenshots from Linux that can be
dropped in to replace the ones that need replacement. Those use the
silver theme that I've been using. Most of the pix in the other chapters
of the OOo Draw Guide don't show anything OOo (unlike in this chapter),
and almost all of the pix were taken on Linux, so they should be okay as
a first cut.

My view is: do this book quickly and then when the design & docs teams
have sorted out what theme is "official" someone can replace all the
screenshots then. Otherwise production of this book, and the Impress
Guide, will drag on far too long.

I have just replaced Chapters 2 through 7 in the Draw Guide Drafts
folder with ones that have been further edited and updated for OOo.
Martin Fox, who did the updating, says he checked it in both OOo and
LibO. So if you continue with the rebranding, be sure to get the latest
copy.

Also, we've got to sort out something so the files show as "checked out"
by you, or I may end up duplicating work you're doing. For example, I
had just checked out Chapters 1, 2, and 3, having forgotten that you
were working on Chapter 1. Just as well I then took a break and came
back to find your note.

--Jean

More (non-obvious) rebranding things:

Chapter title needs to have two blank spaces after the chapter number
(before the linebreak) and no blank spaces at the beginning of the next
line (before the actual title). This makes things line up correctly
(especially with long chapter titles that wrap around) as well as making
everything come out correctly when the chapters are compiled into a
book.

This chapter needs to have the Mac keystrokes info on the copyright
page. I think all the other chapters now have it.

I'm not sure how you're doing the changes to the notes & tips tables,
but it's causing extra blank paragraphs to be inserted. I have set up an
AutoFormat for each of the table types and apply the appropriate one to
the table, so the spacing doesn't change. Unfortunately, AutoFormats,
like AutoText, don't get saved in the template.

Tables of data have a slightly different appearance too. Again, I've set
this up as an AutoFormat, so it's easy to apply to an existing table.

Copyright page acknowledgements are unusually wordy in this book, and
quite a long list, so I suggest a slightly different approach from the
other books, as follows. Only the last line will change from what is now
in each of the chapters.

This chapter is based on an original French document written for
OpenOffice.org 1.x by Michel Pinquier (translated into English by Alex
Thurgood) and previous content revised by Jim Taylor. The chapter was
revised for OpenOffice.org 2.0 by Linda Worthington, Daniel Carrera,
Jean Hollis Weber, and Agnes Belzunce, and later translated into German
by Wolfgang Uhlig. The German revisions were then translated into
English and revised for OpenOffice.org 3.3 and LibreOffice 3.3 by Martin
Fox. Other contributors included Peter Hillier-Brook, Hazel Russman,
Gary Schnabl, and Claire Wood.

I can make the small adjustments necessary in this chapter and drop in
the pictures that I have available, then check it back in. If you want
to work on Chapter 2, I'll cancel my checkout on that one and do chapter
3 next.

--Jean

Oh, and I forgot: We should put Martin Fox's name in the Contributors
list for these LibO chapters, because he checked them for LibO as well
as OOo when he was updating them.

--Jean

Spotted another thing:
The "Tip" tables should have a different background color on the "Tip"
cell. Tips are blue, Notes green, Cautions yellow.

--Jean

Last one, I hope:
OOo book uses the style "Chapter n (Chapter Title)" but LibO books use
"Chapter n, Chapter Title, "

--Jean

Hi :slight_smile:
+1
to continuing to use the silver themes agreed in the documentation team.

The discussions about this in other lists could take forever and we need
documentation out there. The theme arrived at in the Documentation Team really
does seem to be the clearest and best for documentation. It might not be the
best for screen-shots for websites or other places but is the best for
documentation. If other teams ask the Documentation Team to use something that
is not so good for documentation then we can try to deal with that then. One
way that springs to mind is to tell them "to get stuffed" but i'm sure we can
find a more diplomatic way of saying that :wink:

Regards from
Tom :slight_smile:

Hi :slight_smile:
Don't worry about the screen-shots. There are some excellent people in the
Documentation Team that have specialised in taking screen-shots.

If possible it might help them if you can make it clear which screen-shots need
replacing but i suspect they are pretty good at spotting ones that don't meet
their high and exacting standards :slight_smile:

Good work!
Thanks and regards from
Tom :slight_smile: