[libreoffice-documentation] Re: Use of "allow to" in documentation

2016-04-13 Thread ptoye
Sophi and Olivier,

I'm referring to help content only. The changes that I'm making are cosmetic - 
either removing grammatical errors ("allow to") or inserting articles. They 
shouldn't need translating as I'm sure the translators have already corrected 
this in their own languages.

I intend to change 8 files only. I have found a problem, though (see my latest 
thread), and will wait for this to be cleared up before submitting anything.

Best regards,

Peter
mailto:l...@ptoye.com
www.ptoye.com

-
Wednesday, April 13, 2016, 1:41:26 PM, you wrote:


Hi Peter, 
Le 13/04/2016 14:19, Olivier Hallot a écrit : 

> Hello Peter 
> 
> Are you refering to help content or Guide Books? 
> 
> On Guide books, there is no need for bugzilla. 
> 
> On help contents, then it worth to note that HC is translated into 
> several languages. A change in the English string due to a style 
> improvement will put the string in fuzzy state, forcing the translators 
> to review the string. This is not always fun for them, because each 
> language has its style and the change in English may not apply for the 
> target language (I speak for myself because I am a translator). So in 
> case of HelpContent, I recomend proceeding changes of style only when 
> the help file is being touched by a content update, to prevent a massive 
> batch of string review. 

I completely second Olivier here. If there is a possibility of scripting 
to avoid the fuzzy tags on the target languages, then no problem. 
Otherwise, like Olivier said, better to wait for an update or proceed 
only with small volumes. 
Cheers 
Sophie 
-- 
Sophie Gautier [hidden email] 
GSM: +33683901545 
IRC: sophi 
Co-founder - Release coordinator 
The Document Foundation 

-- 
To unsubscribe e-mail to: [hidden email] 
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 




If you reply to this email, your message will be added to the discussion below:
http://nabble.documentfoundation.org/Use-of-allow-to-in-documentation-tp4167829p4181037.html
To unsubscribe from Use of "allow to" in documentation, click here.
NAML



-
Peter
--
View this message in context: 
http://nabble.documentfoundation.org/Use-of-allow-to-in-documentation-tp4167829p4181057.html
Sent from the Documentation mailing list archive at Nabble.com.
-- 
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: Use of "allow to" in documentation

2016-04-13 Thread Sophie
Hi Peter,
Le 13/04/2016 14:19, Olivier Hallot a écrit :
> Hello Peter
> 
> Are you refering to help content or Guide Books?
> 
> On Guide books, there is no need for bugzilla.
> 
> On help contents, then it worth to note that HC is translated into
> several languages. A change in the English string due to a style
> improvement will put the string in fuzzy state, forcing the translators
> to review the string. This is not always fun for them, because each
> language has its style and the change in English may not apply for the
> target language (I speak for myself because I am a translator). So in
> case of HelpContent, I recomend proceeding changes of style only when
> the help file is being touched by a content update, to prevent a massive
> batch of string review.

I completely second Olivier here. If there is a possibility of scripting
to avoid the fuzzy tags on the target languages, then no problem.
Otherwise, like Olivier said, better to wait for an update or proceed
only with small volumes.
Cheers
Sophie
-- 
Sophie Gautier sophie.gaut...@documentfoundation.org
GSM: +33683901545
IRC: sophi
Co-founder - Release coordinator
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] Help files are inconsistent

2016-04-13 Thread Olivier Hallot
Hello Peter

Em 13/04/2016 05:58, ptoye escreveu:
> As part of my efforts to clean up some help files I've found that at least
> one file that I downloaded from git://gerrit.libreoffice.org/help doesn't
> have the same text as in the corresponding LO help file (5.0.5 en-GB). This
> may of course happen on other files.
> 
> This raises the question - is this a deliberate fork or has something gone
> wrong? 
> 
> The file is help/source/text/shared/01/ref_pdf_export.xhp if that's any
> help.
> 

You can get the history of the file in Opengrok:

http://opengrok.libreoffice.org/history/help/source/text/shared/01/ref_pdf_export.xhp

The help content has gaps in contents and updates since long time and
these gaps are progressively being closed by our eforts to deliver a
consistent and precise documentation for users. It however does not
happen in a finger snap, unfortunately.

Regards
-- 
Olivier Hallot
Comunidade LibreOffice
http://ask.libreoffice.org/pt-br

-- 
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: Use of "allow to" in documentation

2016-04-13 Thread Olivier Hallot
Hello Peter

Are you refering to help content or Guide Books?

On Guide books, there is no need for bugzilla.

On help contents, then it worth to note that HC is translated into
several languages. A change in the English string due to a style
improvement will put the string in fuzzy state, forcing the translators
to review the string. This is not always fun for them, because each
language has its style and the change in English may not apply for the
target language (I speak for myself because I am a translator). So in
case of HelpContent, I recomend proceeding changes of style only when
the help file is being touched by a content update, to prevent a massive
batch of string review.

And to answer your question, no need for bugzilla for style changes,
only for content change, update or creation.

Kind regards

Olivier

Em 13/04/2016 05:51, ptoye escreveu:
> One further issue: I don't know the LO bureaucracy but the "allow to" issue
> hasn't been filed as a bug in Bugzilla. Should I do this or isn't it
> necessary?
> 
> 
> 
> 
> -
> Peter
> --
> View this message in context: 
> http://nabble.documentfoundation.org/Use-of-allow-to-in-documentation-tp4167829p4181012.html
> Sent from the Documentation mailing list archive at Nabble.com.
> 

-- 
Olivier Hallot
Comunidade LibreOffice
http://ask.libreoffice.org/pt-br

-- 
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] Getting Started 5.1, Chapter 2 uploaded to feedback folder

2016-04-13 Thread Hazel Russman
I have downloaded chapter 3 and will look at it later.

-- 


H Russman

-- 
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] Help files are inconsistent

2016-04-13 Thread ptoye
As part of my efforts to clean up some help files I've found that at least
one file that I downloaded from git://gerrit.libreoffice.org/help doesn't
have the same text as in the corresponding LO help file (5.0.5 en-GB). This
may of course happen on other files.

This raises the question - is this a deliberate fork or has something gone
wrong? 

The file is help/source/text/shared/01/ref_pdf_export.xhp if that's any
help.



-
Peter
--
View this message in context: 
http://nabble.documentfoundation.org/Help-files-are-inconsistent-tp4181014.html
Sent from the Documentation mailing list archive at Nabble.com.

-- 
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] Re: Use of "allow to" in documentation

2016-04-13 Thread ptoye
One further issue: I don't know the LO bureaucracy but the "allow to" issue
hasn't been filed as a bug in Bugzilla. Should I do this or isn't it
necessary?




-
Peter
--
View this message in context: 
http://nabble.documentfoundation.org/Use-of-allow-to-in-documentation-tp4167829p4181012.html
Sent from the Documentation mailing list archive at Nabble.com.

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