Re: [libreoffice-documentation] graphics for Getting Started Guide for LO v5.0

2015-06-02 Thread Alan Cook

Everybody,

I know perfectly well how to make screen shots in Windows. I was 
avoiding doing that because of the following statement, on p. 14 of Ch. 
2 of the Contributors' Guide, Producing LibreOffice User Guides:

/
//Avoid making screen captures from Windows; use them only as a last 
resort, or as a first draft. First choice for screen captures is Ubuntu 
or another Linux distribution./


If we're sure that John's solution will get us off the hook legally, 
then I'll go ahead and do that.


Best,
Alan

On 6/2/2015 9:53 AM, John Hart wrote:
In windows take screen shot, crop out all the microsoft  references, 
then save as a .png


On 06/02/2015 10:39 AM, toki wrote:


On 02/06/2015 11:26, Ruth Ann wrote:


You can take screen shots with Windows.

If memory serves me right, there is either a formal, or informal policy
of not using screenshots from any Microsoft platform, because Microsoft
claims that usage to infringe upon their copyright.

jonathon








--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted



[libreoffice-documentation] graphics for Getting Started Guide for LO v5.0

2015-06-01 Thread Alan Cook

Hello all,

I need to update Figures 1 and 2 in Ch. 9 (the Math chapter) of GS v5.0. 
I'm running LO on Windows so I can't make my own screenshots. If someone 
who's using Linux could make shots of those two figures and send them to 
me, I can plug them in.


The difference is that the floating dialog won't appear in the new 
figures. Don't worry; the dialog box has been removed entirely from 
v5.0, so you can't mess up.


Thanks,
Alan

--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Getting Started Guide for LO v5.0?

2015-05-28 Thread Alan Cook
So how do we find out what's new in v5.0? Just start working through a 
chapter from the old guide using 5.0 to see if anything doesn't work the 
same way?


On 5/27/2015 11:55 PM, Jean Weber wrote:

As you probably know, the next version of LibreOffice (due out in late
July) will be version 5.0. A Beta1 version is available; it is in
dev-configuration and will install alongside your existing LibreOffice
installation. (Beta2 is due out next week.)

https://wiki.documentfoundation.org/ReleasePlan/5.0#5.0.0_release
https://wiki.documentfoundation.org/ReleaseNotes/5.0

We really should publish at least the Getting Started Guide for v5.0
reasonably close to the time the program is released, don't you agree?

The most recent GS book is for v4.2. I had put all the chapters into a
new template in preparation for people to update content for v4.4; I
did a trivial amount of updating on a few chapters; PeterS and I
updated Chapter 9, but AFAIK nothing else ever got done.

At this point we should skip GS v4.4 and try to do a book for v5.0.
You could start with the chapters here (which are in the new template:
http://www.odfauthors.org/libreoffice/english/getting-started/draft-lo-4.4
Update them and return them to
http://www.odfauthors.org/libreoffice/english/getting-started/draft-lo-5.0
And be sure to put your initials and the date in the relevant boxes on
the Task List, so others know that you've checked out or returned a
chapter.
https://wiki.documentfoundation.org/Documentation/Development/UserGuideTasks#Getting_Started_Guide

If you need some guidance,
https://wiki.documentfoundation.org/Documentation/Development#First_steps_with_the_Documentation_team

And if you'd like to take over the role of leader, coordinator,
herder of cats for Documentation, *please* do so.

--Jean Weber




--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Efforts to Clean Wiki

2015-05-11 Thread Alan Cook

How much disk space would it take?

On 5/10/2015 6:47 PM, Joel Madero wrote:

That's fine - others have volunteered.

On 05/10/2015 02:24 PM, jonathon wrote:

On 04/05/15 02:00, Joel Madero wrote:

Sounds good - interested in helping to coordinate that

After thinking about this for a week or so.

I don't know what the capabilities of the CMS that the wiki uses.

If a notice-template that automatically places the page into a specific
category can be created, then one for each category (Duplicate page,
badly written, outdated, conflicts with, good but not current, good and
current, any other categories needed to clean up pages), be made.
I can walk through the wiki, placing the appropriate notice-template on
the talk page.

Then the easy hack for somebody starting out with documentation is 
ready.


I don't have the disk space to pull the entire wiki onto my laptop, and
throw my tools at it, to determine which pages fall into which 
categories.


jonathon








--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Re: [libreoffice-l10n] guide for scholars

2015-03-05 Thread Alan Cook

This sounds like a good candidate for OmegaT.

On 3/5/2015 5:46 AM, Tom Davies wrote:

Hi :)
Nicely done!  Any chance adding it to the list of 3rd party resources on
the documentation wiki?  Even though it is in Dutch it might be good to
have on the English wiki with just a note to say it is in Dutch?  I'm not
sure but it sounds like you have done a good thing there! :)))
Regards from
Tom :)

On 5 March 2015 at 07:56, Cor Nouws oo...@nouenoff.nl wrote:


Hi,

Recently I finished a guide/handbook for scholars: make your most
beautiful report with LibreOffice Writer - but then in Dutch.
Targeted at 13-16 years that need to write a nice, good report for some
school work. I'll make a simplified version for say 9-11 years.

Will start to promote it soon.
Any advise on how /where to fly to make this available in English too?

Cheers,
Cor

--
Cor Nouws
GPD key ID: 0xB13480A6 - 591A 30A7 36A0 CE3C 3D28  A038 E49D 7365 B134 80A6
- vrijwilliger http://nl.libreoffice.org
- volunteer http://www.libreoffice.org
- The Document Foundation Membership Committee Member

--
To unsubscribe e-mail to: l10n+unsubscr...@global.libreoffice.org
Problems?
http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/l10n/
All messages sent to this list will be publicly archived and cannot be
deleted




--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] tracking who is working on which chapters

2015-01-21 Thread Alan Cook
I believe the page you're talking about is at 
https://wiki.documentfoundation.org/Documentation/Development/UserGuideTasks.


On 1/21/2015 8:27 AM, Tom Davies wrote:

Hi :)
There used to be a wiki-page for signing-out and signing-in chapters
being worked on so that;
* people could track what stage chapters had reached and also to
* help avoid 2 (or more) people attempting to work on a same chapter
at the same time.
Does anyone know how to get to it?  or even whether it still exists or not?

I think ODFauthors already has such a feature built-in so maybe it was
an annoying duplication?  Some people seemed to find it difficult to
find and those who found it seemed to have trouble editing it so i can
easily understand why it might have been taken down but i'm hoping
that it still exists and that it's just me that lost track of where it
is.

Regards from
Tom :)




--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-l10n] Re: [libreoffice-documentation]

2014-11-05 Thread Alan Cook
What it says is I'm putting myself in contact with you. The verb 
/pongo/ means I am putting but can also mean I am wearing, so that 
part's understandable. But the pcs. part has me puzzled. Uds. is a 
standard abbreviation for /ustedes/ (polite 2nd person plural pronoun.) 
Anybody have any guesses?


Alan

On 11/5/2014 3:08 AM, Tom Davies wrote:

Hi :)
+1  :))
I think it proves the point about MTs! ;)

I've never seen anyone wearing a desktop computer!  With watches and
glasses and things that are appearing nowadays i'm not sure how bad things
would get if i took what the MT gave and tried to make sense of it.  Humans
are definitely an important part of the process - we make mistakes too but
probably less bizarre or misleading (nor so frequently).

Regards from
Tom :)



2014-11-05 8:00 GMT+00:00 Sveinn í Felli s...@fellsnet.is:


Þann mið  5.nóv 2014 00:24, skrifaði Tom Davies:


snip /

Hello, I wear contact pcs. ...


Quite entertaining translation ;-)

I think he should be directed to http://es.libreoffice.org/
recibe-ayuda/documentacion/ or maybe just http://es.libreoffice.org
for information in Spanish.

Sveinn í Felli






--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation]

2014-11-04 Thread Alan Cook

Sr. Biela Fernandez,

Aqui es el enlace a la pagina de documentacion española para el paquete 
LibreOffice:


https://wiki.documentfoundation.org/Documentation/es

Parece que actualmente solo existe el /Guia de primeros pasos/, que 
pertenece al todo el paquete LibreOffice. Las guías detalladas para los 
componentes individuales todavía no se han traducido.


Espero que esto sea de alguna ayuda a su organización.

Alan Cook
Voluntario del equipo de documentaciones LibreOffice


On 11/4/2014 6:06 AM, Biela Fernández, Alberto wrote:

Buenos días, me pongo en contacto con uds. Para saber si existen  algún enlace  
a tutoriales oficiales en español para poder descargarlos. Las aulas 
Municipales para mayores de 65 años , propias del ayuntamiento de Madrid 
incluyen el paquete libreoffice y nos gustaría poder aportar a los usuarios, 
acceso a tutoriales sobre el suit.

Muchas gracias por su información

Alberto Biela Fernandez
Trabajador Social
Seccion Centros Municipales de Mayores
Ayuntamiento de Madrid
915883205   biel...@madrid.es




Antes de imprimir este e-mail piense bien si es necesario hacerlo. El 
medioambiente es cosa de todos.

La posible información que pudiera contener este comunicado, relacionada con 
datos de carácter personal, se encuentra amparada en la LOPD 15/99, que 
compromete a no utilizar estos datos para fines que no sean estrictamente 
necesarios para la realización de su cometido, añadiendo además la absoluta 
confidencialidad y exclusividad, quedando prohibida a cualquier persona su 
revelación, copia, distribución o el ejercicio de cualquier acción relativa a 
su contenido. Si recibe este correo electrónico erróneamente ruego nos lo 
reenvíe y lo elimine de todos sus archivos.




--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted



Re: [libreoffice-documentation] Base Handbook Preface updated

2014-09-24 Thread Alan Cook

Jean,

I notice that you uploaded this to the Edited folder. Can we assume that 
anything in this folder is  ready for proofreading and does not require 
extensive review or editing? That's a correct assumption in the case of 
the Preface, and also Chapter 1, Introduction to Base, but (IMO) not 
with regard to any of the other chapters in the Handbook v. 4.2.


I just want to make sure that we're all using the ODFAuthors files in 
the same way to keep track of what's been done and what needs doing.


Best,
Alan

On 9/24/2014 12:35 AM, Jean Weber wrote:

I have updated the Preface to the Base Handbook to remove or replace
out of date information on the Copyright page and in the text of the
chapter. I have put it in this folder:
http://www.odfauthors.org/libreoffice/english/base-handbook/edited42

I plan to go through the other drafts and update the Copyright pages.
I may also do some other editing, or I may not. I'll keep you
informed.

--Jean




--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Translating Base Handbook usin OmegaT

2014-09-10 Thread Alan Cook
Thanks, everyone, for your input.  I think it's best that I continue 
doing what I'm doing for the 4.2 iteration of the Handbook, since the 
actual translating is 99% complete. We should definitely look into using 
OmegaT for future versions, and can start doing that before 4.4 is complete.


Alan

On 9/10/2014 5:32 AM, Sophie wrote:

Hi Tom,
Le 10/09/2014 12:02, Tom Davies a écrit :

Hi :)
It sounds like Alan has developed a good work-flow for what he is doing.

Experimenting with a different system might be useful for updating the Base
Handbook to the 4.4.x branch when that comes out in a few months time.
There is a lot else for the team to do and limited resources to do them.

I was not speaking about the Base book, but about documentations in general.

On the other hand if experimenting with it shows it makes things really
quickeasy then maybe there could be a 4.3.x before the end-of-life of the
4.3.x branch!

Are you willing to help?

There is the danger that trying to do too much could easily result in
nothing getting done so i tend to think it is probably better for Alan to
keep using the work-flow he has developed to complete the 4.2.x = but it's
not up to me and not my decision.

I've never seen danger in adopting tools that help to save time and
resources. And yes, it's Alan decision to work with the tool he choses,
so nothing to say here, however Milos work is a very interesting
alternative that we should explore and document.
Kind regards
Sophie





--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Base documentation volunteers

2014-09-09 Thread Alan Cook

Hello Tom T.,

Welcome to the team! I'm a volunteer (at the moment, the only one, it 
seems) working on updating the Base Handbook. I'd like to supplement the 
information that Tom D. has provided you with and let you know how you 
might start out getting involved with the project.


As Tom indicated, the Base Guide and the Base Handbook are two different 
documents, which is confusing. Base is the only LO product for which 
this is the case; for all the other products, the user manual is just 
called the Guide. However, there is not now, nor has there ever been, a 
complete Base Guide; all there is is the drafts of three chapters.


The reason that there's both a Guide and a Handbook is that the German 
documentation team got tired of waiting around for the English team to 
finish the Base Guide, so they took the draft chapters, translated them, 
finished the book, and published it as the Base-Handbuch. That document 
was then translated back into English as the Base Handbook.


Contrary to what Tom D. indicated, the Handbook is /not/ shorter or less 
thorough than the Guide. Each is intended to be a complete and 
comprehensive user manual; the difference is that the Handbook is 
finished (although not up-to-date in English.) The current German 
version of the Handbook has 448 pages in 11 chapters; the plan for the 
Guide includes 10 chapters, of which only 3 are complete.


The current English Handbook is for version 3.5 of the product. The most 
recent German Handbuch is for version 4.2. What I'm doing right now is 
updating the English Handbook from the more up-to-date German version. 
Someone else has done the translating; I'm basically just 
cutting-and-pasting (although I am finding that I have to do a fair 
amount of translating and editing work as I run across things that don't 
make sense.)


Here's one task we need done right away. The screen captures in the 
German manual are, as one would respect, from the German version of the 
app, and are in German. We need someone to work through the procedures 
described in the Handbook using the English version of the product and 
capture the needed screenshots in English. Moreover, this needs to be 
done by someone who's running Base on Linux. For reasons I don't 
understand, screen captures don't always work correctly when done using 
Windows, and Windows is what I'm running.


If this is something you'd be willing to do, respond to this e-mail and 
I'll send you more details on how to get started.


Best,
Alan C.
On 9/9/2014 6:21 AM, Tom Davies wrote:

Hi :)
I think the immediate one to work on is the Base Handbook rather than the
full guide.  I agree that reading the single chapter in the Getting Started
Guide might help prepare you for Base.
https://wiki.documentfoundation.org/Documentation/Publications
The first book there has a chapter to introduce each of the
modules/programs/apps within LibreOffice.

The Base Handbook is much shorter than the full guide so it might not go
into as much depth as you'd like but it is good to get a broad overview
before getting tooo bogged down in too many of the intricacies.  Also it is
currently being updated quite significantly so it'd be great to do
proof-reading for the chapters as they get completed.  It is the Handbook
that is in most need of proof-reading at the moment.

If you manage to catch up with the translation-update then going on to the
full guide would help gain a much deeper understanding.  The full guide is
more of a longer-term project and is being written from scratch by Dan
Lewis.


Errr, this guide might help you work with the published guides;
https://wiki.documentfoundation.org/Documentation/Development

Hopefully someone might register you at ODFAuthors while you are reading
through that.
Many thanks and regards from
Tom :)


On 8 September 2014 15:41, Joel Madero jmadero@gmail.com wrote:


Hey Tom,

Well there really is no consideration per say. If you want to help,
we'd love to have you assisting! That being said - I'm not terribly
familiar with where to begin in documentation. Perhaps someone else
could give the first steps and get you started.

Thanks for offering to volunteer.

Best,
Joel

On 09/07/2014 09:41 AM, Thomas Taylor wrote:

I would be interested in assisting with the documentation for base,

primarily

the proofreading.  I don't currently use base (or any database) and feel

that

this would help me to also understand the concepts and utilization of

this

portion of LibreOffice.

I use both Linux and Windows although primarily Linux.  I have been a

moderator

for the LO mail-list for about a year and wish to contribute more.  I am

a

retired engineering technician (electro-mechanical) and have been

involved in

producing user documentation and technical manuals for the medical and
automotive fields.

Thanks for your consideration,  Tom Taylor



--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems?

Re: [libreoffice-documentation] Base Handbook Chapter 3

2014-09-06 Thread Alan Cook

Tom,
Yes, Hazel has already done the 4.2 translations. The newly translated 
material is posted on the ODF site, and has been for months. The new 
material in each chapter is in a separate file (one per chapter). That 
new material hasn't been integrated into the existing (3.5) English 
version. That's what I'm doing now. It can be time-consuming on some of 
the longer chapters because we're updating over 3 version changes (3.5 
-- 4.0 -- 4.1 -- 4.2) and sometimes things have shifted around quite 
a bit.


Also, there are a few passages in the German (usually a sentence or two) 
that Hazel missed (very easy to do on a project like this.) I'm 
translating those myself. Also,  find some passage where the English 
translation (both the new stuff and the earlier document) seems to me to 
be overliteral. I would have a difficult time understanding what was 
going on if I were a user. So I'm rewriting those and checking them 
against the app for accuracy and ease of understanding.


Nothing has been done yet with regard to the German 4.3. The plan was 
and still is to get English 4.2 out first. That's what I'm working on.


Best,
Alan
On 9/5/2014 11:58 PM, Tom Davies wrote:

Hi :)
Does the 4.2 need re-translating again?

I thought Hazel had already done the translations?  Does anyone know 
where she might have put the work she did?


Does anyone here know their way around ODFAuthors well enough that 
they can help Alan avoid having to re-do work that has already been done?


Alan, until someone helps you find Hazel's work it might be more 
useful to work on something else.  Apparently a new chapter was added 
to the German 4.3 Base Handbook and translating that might be more 
useful than re-doing work that has already been done.  If the work has 
not been done or can't be found then having that chapter would be even 
more useful to have done.

Many apols and regards from
Tom :)




On 4 September 2014 23:54, Alan Cook alanc...@gmail.com 
mailto:alanc...@gmail.com wrote:


I've uploaded Chapter 3 of the Base Handbook v. 4.2 to

http://www.odfauthors.org/libreoffice/english/base-handbook/drafts_4.2/bh4-2-ch3-tables/view.
As with the previous chapter, it needs to be edited for
consistency of style and checked carefully against the app for
accuracy. Also, it needs English screen captures to replace some
of the German ones. These should be done on a Linux (preferable)
or Mac installation.

Alan

-- 
To unsubscribe e-mail to:

documentation+unsubscr...@global.libreoffice.org
mailto:documentation%2bunsubscr...@global.libreoffice.org
Problems?
http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more:
http://wiki.documentfoundation.org/Netiquette
List archive:
http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and
cannot be deleted





--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


[libreoffice-documentation] Base Handbook Chs. 4 and 5 ready for review

2014-09-06 Thread Alan Cook
Same deal as with the earlier chapters. They're at 
http://www.odfauthors.org/libreoffice/english/base-handbook/drafts_4.2.


Alan

--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] problem w/Base Handbook

2014-09-04 Thread Alan Cook

Hello all,

The immediate solution I've adopted is to reference /both/ GS w/Base 
/and/ the online tutorial in the problematic passage in the Handbook. I 
will post that chapter for review shortly.


As for the long-term issue, there may or may not be one. The question is 
whether or not we want to keep the English and German documentation in 
sync, and also if we want to avoid duplication of content in the English 
documentation.


We're dealing here with 4 documents:

(1)Getting Started with Base, Chapter 8 in Getting Started with 
Libreoffice v.3.5

(2)Einfuehrung in Base, Kapitel 8 in Erste Schritte v.3.3
(3)Creating a Relational Database using Base (online tutorial)
(4)Getting Started with Base in GS w/LO v.4.2

Items (1),(2), and (3) are all versions of each other; item (4) is 
substantially different.


Apparently the way this happened is that an early version of GSw/B got 
translated into German as Einfuehrung in Base. That German chapter has 
stayed the same. When GSw/LO was updated from v.4.1 to v.4.2, the bulk 
of GSw/B was pulled out and made into an online tutorial, and new 
material was written and inserted as Chapter 8 of the print guide.


The new material contains much more detailed information about how to 
use the Wizard to create tables than is in the material moved online. 
Although the online material (item 3) is called a tutorial, the current 
version of Chapter 8 (GSw/B 4.2) actually seems to me to be more 
tutorial-like; the steps it offers are more detailed and it includes 
practice exercises.


If we want to keep the English and the German matching each other, the 
way to do it would be:

-- take the current English online tutorial Creating a relational database
-- restructure it to resemble the Einfuehrung (this wouldn't require 
much if any original writing, just moving some things around)
-- insert the restructured document into Getting Started with 
LibreOffice as Chapter 8.


We'd then have to decide what to do with the /current/ version of GSw/B 
(the one that would be getting replaced). One possibility would be to 
integrate it into the new version. The topics are similar, but 
integrating it would require a lot of editing.


I don't feel qualified to make a decision on how to proceed. Since Jean 
was involved in writing GSw/B 4.2 and presumably knows how and why the 
decision was made to branch the tutorial off from the print guide, 
perhaps we should wait until she's back and get her input.


(Hope that wasn't too confusing. It sure confuses me.)

Alan

On 8/30/2014 10:45 AM, Robert Großkopf wrote:

Hi Jean,

Robert, does the previous English GS chapter, which is now available
as a tutorial, cover the missing info? If so, Alan can just change the
references from GS to the tutorial. Or we could include that tutorial
in the Handbook as an Appendix; that would work too, perhaps better
than sending people to a separate document. But either of those
solutions depends on whether the tutorial covers the necessary info.

Have downloaded
http://wiki.documentfoundation.org/images/1/13/GS40-GettingStartedLO.pdf.
The Base-chapter is the content, which would be missed in the
Base-handbook (for example: Creating tables in Design View).
So a link to Chapter 8 - Getting started with Base would work also for
Base-Handbook 4.2.

I will find a better solution in the next Base-Handbuch by copying the
missed parts of the German Getting started ... into the chapters of
the Base-Handbuch. Haven't seen the Base-Handbuch as a standalone-book.
Thought it was a continuation of Getting started.

Robert




--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


[libreoffice-documentation] Base Handbook Chapter 3

2014-09-04 Thread Alan Cook
I've uploaded Chapter 3 of the Base Handbook v. 4.2 to 
http://www.odfauthors.org/libreoffice/english/base-handbook/drafts_4.2/bh4-2-ch3-tables/view. 
As with the previous chapter, it needs to be edited for consistency of 
style and checked carefully against the app for accuracy. Also, it needs 
English screen captures to replace some of the German ones. These should 
be done on a Linux (preferable) or Mac installation.


Alan

--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] problem w/Base Handbook

2014-08-30 Thread Alan Cook
Whew! I'm afraid it's going to take me a little while to process this 
whole discussion. Thanks, everyone, for your input.


Alan

On 8/30/2014 10:45 AM, Robert Großkopf wrote:

Hi Jean,

Robert, does the previous English GS chapter, which is now available
as a tutorial, cover the missing info? If so, Alan can just change the
references from GS to the tutorial. Or we could include that tutorial
in the Handbook as an Appendix; that would work too, perhaps better
than sending people to a separate document. But either of those
solutions depends on whether the tutorial covers the necessary info.

Have downloaded
http://wiki.documentfoundation.org/images/1/13/GS40-GettingStartedLO.pdf.
The Base-chapter is the content, which would be missed in the
Base-handbook (for example: Creating tables in Design View).
So a link to Chapter 8 - Getting started with Base would work also for
Base-Handbook 4.2.

I will find a better solution in the next Base-Handbuch by copying the
missed parts of the German Getting started ... into the chapters of
the Base-Handbuch. Haven't seen the Base-Handbuch as a standalone-book.
Thought it was a continuation of Getting started.

Robert




--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


[libreoffice-documentation] problem w/Base Handbook

2014-08-29 Thread Alan Cook

Hello all,

I'm updating the English translation of the Base Handbook from 3.5 to 
4.2, and have run across a problem concerning which I'd appreciate some 
advice and feedback.


In Chapter 3, Tables, the section following the heading *Creating 
Tables/Creation using the GUI* begins as follows:


Database creation using the GUI is described in detail in Chapter 8, 
Getting Started with Base, in the /Getting Started with LibreOffice/ 
book. Therefore only the main sources of error are described here.


The problem is that [the first sentence of] that statement is just plain 
false.


The GUI offers two ways of creating tables: Use Wizard to Create Table 
and Create Table in Design View. The /Getting Started/ chapter only 
provides instructions for using the Wizard. The Wizard only provides 
database templates with preexisting table and field names. If you want 
to design a database for any purpose other than the ones that the 
templates cover, it's useless.


So far as I can tell, there are no instructions provided anywhere in our 
documentation on how to create a table in Design View, which seems to me 
to be the method that most users are likely to use. (I could well be 
wrong about this, but if those instructions exist, they aren't located 
in the most logical place to look for them.)


Moreover, the /Getting Started/ chapter explains only how to create a 
flat, single-table database. (I'm not sure why you'd want to do that 
rather than just use a spreadsheet, but . . . .) The material in the 
handbook, on the other hand, assumes that you're building a relational 
database with multiple tables.


The reason I can't just ignore the problem is and go on is: The section 
that follows this introduction contains some new material in the German 
that needs to be translated. Translated super-literally, it doesn't make 
much sense. Good technical instructions are directed at the particular 
situation in which the user is going to need those instructions and 
tailored to the user's preexisting knowledge. That context is exactly 
what the current text doesn't provide, and what I need in order to put 
this stuff into comprehensible English.


Any and all advice appreciated.

Thanks,
Alan

--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] managing expectations and being realistic

2014-08-19 Thread Alan Cook
Hello all,

I started integrating Hazel's translations of the German Base 4.2 Handbook into 
the English 3.5 about a week ago. Chapter 2 is just about ready to go; 
realistically, about a chapter a week is the rate at which I can work on 
this(but see below.)

I think it'd be worthwhile for me to keep working on that, even though the 
German 4.3 handbook is out now. The changes are cumulative, and text rarely 
gets deleted, so everything that's in 4.2 is probably going to be in 4.3. (I 
can do a quick comparison of the German 4.2 and 4.3 to confirm that.)

As I said, about a chapter a week is what I can do, and even that's optimistic. 
But if the team really wants to make a push to get all the manuals updated to 
the current version, I can rearrange some commitments and make this more of a 
priority. Let me know.

Alan




On Tue, 8/19/14, Tom Davies tomc...@gmail.com wrote:

 Subject: Re: [libreoffice-documentation] managing expectations and being 
realistic
 To: Jean Weber jeanwe...@gmail.com
 Cc: Documentation@global.libreoffice.org 
documentation@global.libreoffice.org
 Date: Tuesday, August 19, 2014, 8:33 AM
 
 Hi :)
 If/when new people join the group how do they
 know what to start on?  What
 do we tell
 them?
 
 If we could say that
 a specific guide is next in line to be updated
 then
 they could just start on that
 straight-away, or they could then say that
 they would prefer to work on something else.
 
 At the moment people just
 stand around waiting for them to guess what might
 be good.
 
 Also
 it might be easier to recruit new people for the team by
 saying that
 some specific guide needs
 work.
 Regards from
 Tom :)
 
 
 
 
 
 On 19 August 2014 13:10,
 Jean Weber jeanwe...@gmail.com
 wrote:
 
  Having a
 policy is all very well, but really it's up
 to the people
  who do the work. For
 example, if no one will do the Calc Guide, it
  doesn't get done. No policy will
 change that. This is why some guides
 
 were updated to 4.0, but others not until 4.1: no one
 available to do
  them.
 
  For now, Writer Guide
 4.2 will be finished; Draw Guide will be done
  for 4.3; GS will skip 4.3 and go to 4.4
 unless someone commits to an
  update
 sooner. The others: who knows? Will someone do Calc or
 Math?
 
  --Jean
 
 
 
 On Tue, Aug 19, 2014 at 7:33 PM, Tom Davies tomc...@gmail.com
 wrote:
   Hi :)
 
  This team consistently does far more work than most
 other Documentation
   Teams i've
 seen in almost any other project.  MS Office only manages
 1
  set
   in 3-4
 years.
  
  
 Looking down the list of Published Guides we can see that
 all guides
  (apart
 
  from 2) have had at least 1 completed version in the
 4.x.x line.  GS has
   had 2. 
 Writer is over half-way through it's 2nd.
  
   It's
 only the Base Handbook that hasn't had any and frankly
 i'm impressed
   that there is
 one at all.  It would be nice to get a new one but it
 might
   be better to skip several
 branches and get the one that covers the newer
   back-end.
 
 
   It seems a good policy to
 deliberately skip at least 1 branch, maybe 2.
   Lets say each Guide can skip 2
 branches quite comfortably.  That way
 
 there
   is under half the guides to
 do each time.
  
 
  That seems a much more realistic goal to me and means
 you can feel
   justifiably chuffed
 with the amazing amount of work that you do rather
  than
   feeling bad
 about not having achieved unrealistic targets.
  
   So lets say
 that since the Draw Guide already has a 4.1.x branch
 done
  and
 
  dusted  that it does not need a 4.2.x and
 probably not a 4.3.x either.
   Any
 changes or additional functionality can be pieced together
 by users
  if
  
 they can't figure it out.  The existing Guide gives
 plenty of help for
   people to
 understand how Draw works so people should be able to
 figure
  out
  
 how other functionality fits in and what the over-all ways
 of thinking
   are.
  
   The Math
 Guide's latest was the 4.0.x so that could probably use
 a 4.3.x.
  
  
 It might be really good to finish off the Writer's 4.2.x
 since it's over
   halfway done
 already.  Or would it be easier to move straight to a
 4.3.x?
   or just leave it as is and
 leave it until the 4.4.x and then try to do a
   complete guide for that branch?
  
   If we do
 decide to set a policy of skipping every other branch
 then
   skipping the GS makes a lot
 of sense.  Do we really need a 4.3.x for the
   GS?  I think most people are going
 to find that the existing 4.2.x GS
 
 Guide
   is more than enough.
  
   If we set a
 policy then new people can be guided to work on Guides
 that
  fit
   into
 that policy.  Obviously if they have strong reasons for
 going
  outside
  
 policy then they can try that and it would be very positive
 but many
  people
 
  starting here want to be given tasks so that they can
 become familiar
  with
   the process and feel like part of a
 team.
  
   If
 we decide to set a policy of skipping every 

[libreoffice-documentation] French FAQs?

2014-03-19 Thread Alan Cook
Hello. I've just signed up as a documentation volunteer. I notice that on the 
FAQ page there's a note about needing help with translating the questions from 
French, but when I compare the French and English pages it looks like 
everything's already been translated. Is there anything else that needs to be 
translated? If so, I'd be glad to do it.

Alan

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted