Writer Guide status / my role

Things like that, of substance, seem to me worth doing now, unlike some of
the cosmetic stuff.

But if others think I should skip it for now, that's okay with me. David,
what do you think?

Hal

It is your choice. I was only trying to give you an option. The best way to
handle it is do as you want :wink:

Regards from
Tom :slight_smile:

Hi Hal, Tom, :slight_smile:

I am not paying much attention to terminological consistency, as I think
that's a "nice to have" that can wait until the next release of the book and
I'm not great at that level of detail anyway. I am trying to do all the
rebranding things, but no doubt I'll miss something that someone will pick
up on the next pass.

I think you're right about the terminology consistency. The most
important thing is that instructions should be *understandable* for
the audiences we target. In my own professional work, when I know I'm
addressing people with a certain level of understanding of a subject,
I sometimes use different terms for the same thing to arrive at a
nice, natural writing style - you don't want to sound too wooden.

Provided that it doesn't create a source of confusion for your
readership, I think it's OK.

My 2 cents.

Anyway, we give it our best shot, and then the proofreader can always
make adjustments. :wink:

I'll be there to help out just as soon as I've sent my current job
back to the client (deadline on Monday). :wink:

David Nelson

Well, I've done that particular topic now, and I'll be uploading the chapter
soon and moving on to another one.

Hal

And I still totally HATE HATE HATE the way Alfresco keeps logging me off.
Grrr, snarl.

Hal

You are fast. It's great :slight_smile:
Regards from
Tom :slight_smile:

Hal,

I stayed logged in to 1 page overnight! I fell asleep before making changes and
it would have let me edit about 10hours later! I closed it and clicked on the
email link and it didn't ask me to re-login again!

My web-browser is SeaMonkey which uses the same engine as Firefox (gecko) but i
don't generally save passwords. I had not changed any setting in my profile at
Alfresco so everything is just on defaults i think.

I like it this way. Very easy and convenient for me!
Good luck in getting this sorted sometime! Perhaps try a different
web-browser??

Regards from
Tom :slight_smile:

Are you talking about the *website* or about Alfresco?

I haven't used the website enough to know if it will allow me to stay logged
in, but Alfresco (and the wiki) keep kicking me off.

Hal

Alfresco keeps me logged in so i can edit without having to do the login process
??

Weird but nice :slight_smile:
Regards from
Tom :slight_smile:

But, but... we don't edit within Alfresco online; we download the ODT files
and edit there.

Sounds to me like you're talking about Silverstripe, the website editor,
where we DO edit online.

Hal

Oh no! You're kidding! Yes i have been using SilverStripe :frowning:

I just tried to publish the localisation page as it looked ready.
https://www.libreoffice.org/get-involved/localizers/?stage=live
Ahh, great. Now i can see my correction :slight_smile: The page does look done&dusted to
me.

Have i been bad?
Regards from
Tom :slight_smile:

That explains why some of our recent exchanges have seemed to me to be a bit
"in different universes".

Doesn't sound like you've been bad. David asked for help with the website,
and you're helping. Silverstripe is what you/we use for editing the website.

Alfresco is where the user docs (and a few other things) are produced.

BTW, the CMS messages are coming from Silverstripe, and not Alfresco. And
you are probably getting emails from the website list as well as this
(documentation) list, and possibly others that you've subscribed to... hence
the "hundreds of emails" you referred to earlier.

Hal

Ahhh, that does explain things.

Yes, the emails link's take me to SilverStripe. "Hundreds" was an
exaggeration. It has been enough to be annoying but nothing like that many!

So, with Alfresco you get to see proper document-mark-up of some kind so you can
edit links and stuff presumably. I was just about to ask about how to do that.
What mark-up language is used? Do you use gedit? If so which setting do you
choose; plain-text, html or docbook or something else?

Many thanks for helping me there! It's a relief!
Thanks and regards from
Tom :slight_smile:

We are not using Alfresco to work on web pages. It can do that, but we're
not using it that way.

We are using Alfresco to store .odt files and track our work on them. To
edit one, you check it out, download it, edit it in LibreOffice offline,
then upload it and check it in again. Jeremy has written a very helpful
"bootcamp" document about the details.

Hal

What I've found is that the only step that takes significant amounts of time is checking the figures -- I get through all the other stuff in less than half an hour, and the majority of that is changing the > signs to arrows in OOoComputerCode. So the changing of the tables, using context menu and menu bar, and so on is basically in the noise. I think we have to consider online users and not just printed copy users; the

You're right, the whole Title Page thing is new. There seem to be some things missing, too -- I've submitted a couple of bugs, which turned up when I was trying to verify figures.

Hi :slight_smile:

I think people have got to do what they works best for themselves. After we
have finished and got 1 set of completed documentation out there then we can
work at fixing inconsistencies and detail.

Obviously that is going to be easier when we get to the pages you have done and
you are likely to find it easy to fix tables and coding on a few people's
pages. "Speed is of the essence" now because we have product out there, fully
released, but with no documentation to back it up. If we can get a 2nd release
of documentation out there soon after our 1st then we might redeem ourselves. I
do realise i am the slacker here. I can see all you guys working hard and
getting excellent results fast.

Good luck and regards from
Tom :slight_smile:

What I've found is that the only step that takes significant amounts of
time is checking the figures -- I get through all the other stuff in less
than half an hour, and the majority of that is changing the > signs to
arrows in OOoComputerCode. So the changing of the tables, using context menu
and menu bar, and so on is basically in the noise.

We have approximately 60 chapters to do. If 15 minutes are spent per chapter
doing nonessential rebranding things, that's *15 hours* of time that could
have been better spent on something more productive.

I think we have to consider online users and not just printed copy users;
the

This sentence has been truncated. I'm wondering what you intended to say.

Hal

Hi :slight_smile:

I think you 2 are the main people doing the work so i think a lot of people
regard you both very highly. People work better in different ways and it is
good to hear hints&tips from the people that are having success. I am still
struggling with basics and distractions, sorry.

Regards from
Tom :slight_smile:

Yes, sorry -- hit send too soon! What I meant was that the colors are very noticeable in the PDFs and anything else other than grayscale-printed copies. Even with the grayscale, the difference between white and not-white shows up.