[libreoffice-documentation] Status of Getting Started Guide

2020-12-22 Thread Jean Weber
With the "festive season" upon us (even if we can't travel), I don't
expect to see any further work being done on the GS Guide - though it
would be welcome if someone isn't otherwise occupied and wants to work
on it. Two chapters are still checked out for updating; I hope to see
a first draft in early January. Many other chapters are awaiting a
second review.

I hope everyone is well and stays well. I live in a safe place, so I'm
not going anywhere in the next few months.

Jean

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy


[libreoffice-documentation] GS7006 Impress

2020-12-22 Thread Jean Weber
Peter,
This chapter is now in the WiP folder for Getting Started Guide, ready
for you to accept or reject my changes and suggestions. Much of what
I've done is to make the formatting and wording of the chapter more
compatible with the rest of the book.
Other reviewers should wait until Peter has a chance to go through
this chapter, before doing a second review.
Jean

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy


Re: [libreoffice-documentation] new member

2020-12-22 Thread Dave Barton

 Original Message 
From: Peter Heijink [mailto:peterheij...@kpnmail.nl]
Sent: Tuesday, December 22, 2020, 17:02 UTC
To: documentation@global.libreoffice.org
Subject: [libreoffice-documentation] new member

> Hi reader,
> 
> I'm a satisfied user of LO, since seven years now. Focus on base and
> programming macros, some of them written in python.
> 
> The question of this mail is:
> 
>  * can you assign me to the right team / tasks?
> 
>  * is the contribution driven by the needs of the documentation team,
>    or can initiatives of the volunteer  be granted as well?
> 
> I noticed that (base) python programming is less abundant, in usage and
> documentation. I'm willing to contribute and add documentation on this
> subject.
> 
> Regarding skills, i am 64, retired and not educated as a programmer,
> though with a background in engineering and some programming languages.
> 
> 
> Looking forward to what you believe can be a suitable area to work on.
> 
> kind regards peter heijink

Hello Peter and Welcome,

If you have not already done so, please subscribe to the documentation
team mailing list documentation+subscr...@global.libreoffice.org, which
is where we communicate and discuss all matters related the the
LibreOffice documentation and Help production.

Being an open source volunteer project we do not assign tasks to
contributors. We ask them to look for aspects of the various sections of
the LibreOffice documentation where they believe their skills may be
usefully employed. As a general rule (not law) we discuss with or advise
the other team members what we wish to work on via the mailing list.
This often produces useful feedback or guidance for new contributors.

If you would like to speak with our "Slave Driver" :)) oops I mean "Team
Leader" Olivier Hallot and some other regular members of the docs team,
we hold a bi-weekly on line team meeting:
https://wiki.documentfoundation.org/Documentation/Meetings

The contributor guides are currently in a state of flux, but you should
find sufficient information about joining the team in the "Help produce
documentation" section of our wiki here:
https://wiki.documentfoundation.org/Documentation

Best Regards
Dave


-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy


[libreoffice-documentation] new member

2020-12-22 Thread Peter Heijink

Hi reader,

I'm a satisfied user of LO, since seven years now. Focus on base and 
programming macros, some of them written in python.


The question of this mail is:

 * can you assign me to the right team / tasks?

 * is the contribution driven by the needs of the documentation team,
   or can initiatives of the volunteer  be granted as well?

I noticed that (base) python programming is less abundant, in usage and 
documentation. I'm willing to contribute and add documentation on this 
subject.


Regarding skills, i am 64, retired and not educated as a programmer, 
though with a background in engineering and some programming languages.



Looking forward to what you believe can be a suitable area to work on.

kind regards peter heijink


--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy


Re: [libreoffice-documentation] Contributors' Guide - Chapter 2

2020-12-22 Thread Dave Barton
On 22/12/2020 10:24, Peter Schofield wrote:
> An updated version of Chapter 2 Producing LO Guides is now on NextCloud.
> The updates to the chapter are from comments and suggestions made by Rafael.
> 
> Regards
> Peter Schofield
> psaut...@gmail.com

I have taken and reviewed the updated Chapter 2 Producing LO Guides, I
have not made any edits, so I did not turn track changes on. However I
have added many comments for consideration.
The previously updated chapter has been move to the "Archives" folder
and "2-ProducingLOGuides-PS-RL-PS-DB-20201222.odt" is now in the WIP
folder: https://nextcloud.documentfoundation.org/s/7kRae4WJ4w57tRH

Regards
Dave

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy


[libreoffice-documentation] Contributors' Guide - Chapter 2

2020-12-22 Thread Peter Schofield
An updated version of Chapter 2 Producing LO Guides is now on NextCloud.
The updates to the chapter are from comments and suggestions made by Rafael.

Regards
Peter Schofield
psaut...@gmail.com




-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy



Re: [libreoffice-documentation] Fwd: [libreoffice-l10n] Suggestion for workflow modification : a new directory "Prepared for translation" with "cleaned" files

2020-12-22 Thread Milos Sramek
Hi Martin,

thank you for returning back to the issue!

Meanwhile I've thought a lot about "labor division" in the case of
cleaning.

Perhaps it would be best if the manual style cleaning (as described on
https://github.com/milossramek/translation-scripts/tree/master/odtclean) 
would become one of the duties of the author, who prepares the published
files (but the list of their duties is already quite long now) and
preparation of the files in the Cleaned directory by running the script
(once a guide is published) would be a task for somebody else (me for
now). I think that it should not be among the author's duties, since I
think that running a python script on Windows for a non-developer is not
an easy task (I would, e. g. install the Windows-for-Linux subsystem and
install Ubuntu there :D ).

If we agree to add the  "Cleaned" directory (in my text below I
suggested "Prepared for translation", but "Cleaned is perhaps better), I
would create it in the 7.0 version of the Calc guide and Math guide,
which are already published, and do both the manual and script cleaning.

Milos

On 12/21/20 3:37 PM, Martin Srebotnjak wrote:
> Just reminding of this suggestion by Milos from August 2020.
>
> +1
>
> Lp, m.
>
> V V čet., 6. avg. 2020 ob 14:39 je oseba Olivier Hallot <
> olivier.hal...@libreoffice.org> napisala:
>
>> Forwarding to the documentation mailing list
>>
>> Important topic.
>>
>>
>>  Mensagem encaminhada 
>> Assunto: [libreoffice-l10n] Suggestion for workflow modification : a new
>> directory "Prepared for translation" with "cleaned" files
>> Data: Thu, 6 Aug 2020 14:30:14 +0200
>> De: Milos Sramek 
>> Para: Libreoffice ln10 
>>
>> Hi,
>>
>> document 'cleaning' has been mentioned recently in several threads. It
>> is a necessary step for subsequent translation of the guides to
>> different languages. As it  is currently done 'on request', I suggest to
>> add cleaning as a compulsory step to the workflow (described here:
>>
>> https://wiki.documentfoundation.org/Documentation/DocumentationTeamInfo/UsingAuthorsWebsite
>> ).
>>
>> Currently I put the cleaned files here:
>>
>> https://nextcloud.documentfoundation.org/index.php/apps/files?dir=/Shared/SK%20community/Cleaned
>> .
>> Probably nobody knows about them.
>>
>> What is cleaning about:
>>
>> For translation we use the OmegaT tool, which extracts strings for
>> translation directly from the document's xml. This means that the
>> character formatting tags are visible for her/him (tags in OmegaT are
>> abbreviated to ... or similar). Usually there are too many
>> useless tags (tags seem to remain in the code forever, even if
>> formatting is removed), which complicates the translation process (too
>> many tags, words split by tags to pieces etc). In cleaning all direct
>> character formatting is removed (by a python script) which decreases the
>> amount of tags to the necessary minimum.
>>
>> My suggestion:
>>
>> Add an additional step in the workflow after "Published" (after it in
>> order to not to change to current authoring workflow) by adding a new
>> directory "Prepared for translation". From there (1) a translator would
>> take documents for translation and (2) these documents would be used to
>> start a new version of the given Guide.
>>
>> Who will do that:
>>
>> I volunteer to take care of the cleaning process. I will also create a
>> guide, how to do that and also will place the script to the nextcloud,
>> so that eventually somebody else can do that. As a part of the cleaning
>> process one has to visually check the documents and change eventual
>> direct formatting to the an appropriate character style.
>>
>> thanks for consideration
>>
>> Milos
>>
>> --
>>
>> email & jabber: sramek.mi...@gmail.com
>>
>>
>> --
>> To unsubscribe e-mail to: l10n+unsubscr...@global.libreoffice.org
>> Problems?
>> https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
>> Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
>> List archive: https://listarchives.libreoffice.org/global/l10n/
>> Privacy Policy: https://www.documentfoundation.org/privacy
>>
>> --
>> Olivier Hallot
>> LibreOffice Documentation Coordinator
>> Comunidade LibreOffice
>> Rio de Janeiro - Brasil - Local Time: UTC-03:00
>> http://tdf.io/joinus
>>
>> --
>> To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
>> Problems?
>> https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
>> Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
>> List archive: https://listarchives.libreoffice.org/global/documentation/
>> Privacy Policy: https://www.documentfoundation.org/privacy
>>

-- 
email & jabber: sramek.mi...@gmail.com


-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: