C | 27 Nov 12:46 2015
Picon

Work on the LibO Doc Wiki

Hi.

Just a quick FYI for the team.

I've started poking at the Wiki.  I just translated this page over from French:
https://wiki.documentfoundation.org/Faq/Impress/024  The usual "feel
free to mercilessly edit" applies of course :-)

Clayton

--

-- 
To unsubscribe e-mail to: documentation+unsubscribe <at> 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
Peter Toye | 24 Nov 12:35 2015

Re: Re: Can I help?

Hi Lera,

Thanks for your comments. As a first-time producer of LO documentation I wasn't sure about the MS Office
reference. I put it in as many years ago I used Office, and found that the LO syntax rules for parameter
names/prompts a bit confusing when I tried to put some spaces in. But I'm 100% happy for you to remove that
paragraph. I realise that LO is nothing whatsoever to do with Office!

"Designer/developer". No problem with changing it. Your wording is better. I should have thought of it.

"User". We need some word to describe the person who is using the database, as opposed to the person
developing it. After all, the concept of the parameter query was designed to allow the person using the
database to input parameter values. Do you have a better word? Maybe recast the sentences using it to say
something like "at run-time". If you prefer that I'll send a revised version in, but I think it will be
difficult not to mention the fact that it's a human being that inputs the parameter value.

Your English is better than my Russian!

Best regards,

Peter
mailto:lo <at> ptoye.com
www.ptoye.com

-------------------------
Monday, November 23, 2015, 6:31:21 PM, you wrote:

> Hi Peter,

> Your changes look very good. It really begins to look more professional and
> easier to read and translate. Thank you a lot for your contribution. I can
(Continue reading)

Lera | 25 Nov 00:01 2015
Picon

Re: Re: Can I help?

Hi Peter,

В письме от 24 ноября 2015 07:47:51 пользователь ptoye написал:
> "User". We need some way to distinguish the person who is using the database
> from the person developing it. After all, the concept of the parameter
> query was designed to allow the person using the database to input
> parameter values. Do you have a better word? Maybe recast the sentences
> using it to say something like "at run-time" (which is in the first
> sentence. If you prefer that I'll send a revised version in, but I think it
> will be difficult not to mention the fact that it's a human being that
> inputs the parameter value. I notice that the original version had "you" -
> whoever that might be - which strikes me as even less professional.
I agree with you. Combination of words such as "you must" and "you can" must 
not be used in the Help.
I have read again, and I think that I interpreted a paragraph "The user can 
use the SQL wild-card characters..." wrong. You are right. This paragraph 
needs it.

> There's also the problem of the paragraph which I didn't understand. I think
> that what the original author was trying to say was that parameter queries
> are commonly used in subforms to restrict the records to be displayed. Is
> that your impression? If so, I can rewrite it. It also should be moved to
> the section on Parameter queries - it's nothing to do with input.
Do you say about this "Parameter queries are also used for subforms, since 
they work exclusively with queries for which the values to be invoked are read 
internally from a variable."?
I think that it needs to be moved in the Parametr query section.

Best regards,
Lera
(Continue reading)

ptoye | 24 Nov 17:53 2015

Re: [libreoffice-l10n] Possible help files rename?

Hi Jan,

I think that you are writing about me. But I should point out that Sophi and Regina here were extremely
helpful and showed me the main_transform file which puts the file name and path at the head of the text. Then
I found the file I wanted immediately. 

I agree that meaningful file names might help - but in which language? Even US and UK English may differ. And
I've no idea what the Czech for "query" is!

An even higher barrier is that my system is based on Windows, and most of the tools used here are Unix-based -
you mention grep. There are almost certainly Windows equivalents, but they take a bit of finding and don't
always work too well.

I appreciate your views, and your support for me, but I have to agree with Martin.

Best regards,

Peter
mailto:lo <at> ptoye.com
www.ptoye.com

-------------------------
Tuesday, November 24, 2015, 3:30:23 PM, you wrote:

Hi Martin, 

We have just seen a guy interested in editing help, and this was one of 
his struggles there - that he just couldn't find the help file he needs 
to edit.  Asking him to grep all the main0123.xhp files (and alike) is 
just as nice as telling him "go away, we don't want you" :-( 
(Continue reading)

ptoye | 24 Nov 15:47 2015

Re: Can I help?

Hi Lera,

Thanks for your comments. As a first-time producer of LO documentation I wasn't sure about the MS Office
reference. I put it in as many years ago I used Office, and found that the LO syntax rules for parameter
names/prompts a bit confusing when I tried to put some spaces in. But I'm 100% happy for you to remove that
paragraph. I realise that LO is nothing whatsoever to do with Office!

"Designer/developer". No problem with changing it. Your wording is better. I should have thought of it.

"User". We need some way to distinguish the person who is using the database from the person developing it.
After all, the concept of the parameter query was designed to allow the person using the database to input
parameter values. Do you have a better word? Maybe recast the sentences using it to say something like "at
run-time" (which is in the first sentence. If you prefer that I'll send a revised version in, but I think it
will be difficult not to mention the fact that it's a human being that inputs the parameter value. I notice
that the original version had "you" - whoever that might be - which strikes me as even less professional.

There's also the problem of the paragraph which I didn't understand. I think that what the original author
was trying to say was that parameter queries are commonly used in subforms to restrict the records to be
displayed. Is that your impression? If so, I can rewrite it. It also should be moved to the section on
Parameter queries - it's nothing to do with input.

Your English is better than my Russian!

Best regards,

Peter
mailto:lo <at> ptoye.com
www.ptoye.com

-------------------------
(Continue reading)

Lera | 23 Nov 19:31 2015
Picon

Re: Re: Can I help?

Hi Peter,

Your changes look very good. It really begins to look more professional and 
easier to read and translate. Thank you a lot for your contribution. I can 
prepare the patch in the nearest future.

I have only a few proposals.
We can not use a reference to an application of a competitive office suite like 
MS Access. In the official Help this looks very strange. If we assume that a 
human can have difficulties in learning LibreOffice from habits to work with 
another popular office application, we need to tell about differences, but 
without using reference to this application. LibreOffice is not a fork of MSO. 
There are many other office suites as GoogleDrive, GNOME Office, Calligra Suite 
etc. And we should not make a comparative table out of the Help.
I think that the sentence “For designers familiar with Access, the prompt is 
more restricted as it cannot contain spaces or reserved characters.” needs 
changing.

A mention of a user does not let the Help to look professional. In my opinion, 
this can be done for a Guide or FAQ, but we need to avoid it, and to focus on 
a functional description.

The last, for me “designers of a database” looks strange. I am used to see 
“developers of a database”. I am not an English native speaker, and I can not 
be sure, but when I get the order on a database, usually I am called 
“developer”. I really don't know what we need to use in this case, just to 
draw your attention.

What do you think about these?

(Continue reading)

toki | 22 Nov 21:18 2015
Picon

Re: Help Writer's Guidelines


On 30/10/2015 21:24, Yousuf 'Jay' Philips wrote:

> as a possible, a help writer's guidelines needs to be created to guide users who modify help to write in a
particular style.

There is _Chapter 5 Style Guide_ in _The LibreOffice Contributor's Guide_.

To supplement those guidelines, it recommends:
* _The Chicago Manual of Style_. University of Chicago Press;
* _Read Me First! A Style Guide for the Computer Industry_. Sun
Microsystems;
* _The Modern Language Association (MLA) guidelines_;

I'll grant that the absence of a specific edition of _The Chicago Manual
of Style_, or specific edition, and version of _The MLA Guidelines_
might be result in stylistic differences between contributors, if they
use different editions/versions of those texts.

I've a dim memory of a different set of guidelines, from the days of OOo
1.x, that was used outside of the group that became ODFAuthors.

jonathon

--

-- 
To unsubscribe e-mail to: documentation+unsubscribe <at> 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
(Continue reading)

ptoye | 22 Nov 12:51 2015

Re: Can I help?

Here it is - I think.

02010100.xhp
<http://nabble.documentfoundation.org/file/n4167017/02010100.xhp>  

-----
Peter
--
View this message in context: http://nabble.documentfoundation.org/Can-I-help-tp4166244p4167017.html
Sent from the Documentation mailing list archive at Nabble.com.

ptoye | 22 Nov 13:00 2015

Re: Can I help?

I've uploaded it to the bugzilla site. Thanks for your help.

-----
Peter
--
View this message in context: http://nabble.documentfoundation.org/Can-I-help-tp4166244p4167018.html
Sent from the Documentation mailing list archive at Nabble.com.

Dan Lewis | 22 Nov 03:03 2015
Picon

Base Guide ch 1 uploaded

I have uploaded this chapter, Introducing Base, here:

http://www.odfauthors.org/libreoffice/english/base-guide/draft-5.x/introducing-base/view

Now I am starting work on Chapter 2, Planning/Designing Your Database

--

-- 
To unsubscribe e-mail to: documentation+unsubscribe <at> 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
Amy Mason | 21 Nov 22:10 2015

Documentation volunteer

Hello LibreOffice Documentation Team,

My name is Amy Mason and I am currently in my third year of university, studying English Language and Literature.

I am sending this email as I would love to write for LibreOffice's documentation team. As a current English
student, I am constantly using LibreOffice to write, edit and proofread assignments and reports. I would
love to use these skills by working with the LibreOffice documentation team to create user guides and
manuals. I also want to immerse myself in technical writing and I would appreciate any opportunity at
LibreOffice to practice this. 

I’m also writing to request a user account on the ODFAuthor’s site. 

If you need any other information, I am more than happy to provide it. You can contact me at this email,
masonamy <at> icloud.com <mailto:masonamy <at> icloud.com>.

Kind regards,

Amy Mason
--

-- 
To unsubscribe e-mail to: documentation+unsubscribe <at> 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

Gmane
http://blog.gmane.org/gmane.comp.documentfoundation.libreoffice.documentation
blog.gmane.org
crawl=CC-MAIN-2015-48
59522
application/http; msgtype=response
sha1:FOGCZPPVOTB6VO7SBS3XSH2WVF5RC4SZ
<urn:uuid:f2d89a29-2371-4e8c-9f35-8cbc4342d0b4>
2015-11-27T11:55:03Z
80.91.229.12
sha1:MT5W4D6OG2KGIMYEOG7WHWWHOAMDA7CA
<urn:uuid:1c5a6c58-5716-4c98-965e-e3ccdf607b82>
http://blog.gmane.org/gmane.comp.documentfoundation.libreoffice.documentation
response
<urn:uuid:4bdb31e5-8856-419a-8e31-4aa2bb845ee8>
robots: classic
hostname: ip-10-71-132-137.ec2.internal
software: Nutch 1.6 (CC)/CC WarcExport 1.0
isPartOf: CC-MAIN-2015-48
operator: CommonCrawl Admin
description: Wide crawl of the web for Nov 2015
publisher: CommonCrawl
format: WARC File Format 1.0
conformsTo: http://bibnum.bnf.fr/WARC/WARC_ISO_28500_version1_latestdraft.pdf