Re: [libreoffice-documentation] Coordination, mentoring, etc

2014-09-04 Thread Sophie Gautier
Hi Jean, all,

Sorry to not have post before but I was focusing on the LibreOffice
conference and wanted to have time to read the mails of the list.
So I would like to volunteer to coordinating the work on this project.
For those who don't know me, I'm with LibreOffice since the beginning of
the project, I'm working for TDF on a paid basis as release coordinator and
administrative assistant. On my volunteer time, I used to localize the UI
and help of LibreOffice in French, do some QA, and translated some part of
the FAQ from French to English. My English is not good enough to write the
English documentation, but I quite well know all the parts of this project
to be able to help his coordination and help new comers to find their way.

Let me know if you would like me to help on this task :)
Kind regards
Sophie



On Tue, Aug 26, 2014 at 2:49 AM, Jean Weber jeanwe...@gmail.com wrote:

 IF people in this group think some coordination and/or mentoring is
 needed or at least would be useful, the group needs to find someone or
 several people to do that, do it consistently, and do it well.

 I do a bit now and then, but I have not been doing it consistently,
 have no intention of doing it consistently, and will probably be doing
 even less in future. I've been saying this for months, but is anyone
 listening?

 If we can't find one or more volunteers to take on this sort of
 responsibility, perhaps we should make a case for TDF to fund someone,
 at least part time? IMO we would need to hire someone with experience
 in technical communication, project management, and mentoring new team
 members. Preferably someone with experience coordinating volunteers,
 so they don't have inappropriate expectations of giving people
 assignments and getting the work done to a schedule. (No, I'm not
 looking for a job.)

 I'm not at all sure that would help enough, because we would still
 need people who have both the time and knowledge to do the actual
 work. Our problem, AFAICT, has not been in attracting volunteers. The
 problem is attracting -- and keeping -- the right volunteers: that is,
 people with the time and knowledge.

 BTW, I find it both encouraging and discouraging to note that the AOO
 Docs group appears to have the same problems that we do.

 --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




-- 
Sophie Gautier sophie.gaut...@documentfoundation.org
Tel:+33683901545
Co-founder - Release coordinator
Certification Committee Member
The Document Foundation

-- 
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