Re: [libreoffice-documentation] simplifying documentation

2017-07-28 Thread Cathy Crumbley

Hi Cor,

I appreciate your advice about how to get the wording revised on the 
program download page. Unfortunately, I don't know what adding 
"needsUXEval to the keywords field" means.


Could you please translate into plain English?

Thank you.

Cathy

On 7/28/2017 3:16 AM, Cor Nouws wrote:

Hi Cathy,

Cathy Crumbley wrote on 28-07-17 06:18:


Just to be clear, I was not expressing problems with the Help files. In
fact,  I was not even aware that they exist when I wrote this.

In know that you was talking about the user interface. That is what my
comment is about too ;)


On 7/27/2017 3:52 AM, Cor Nouws wrote:


Indeed issues are the proper way to suggest better wording.
You may add needsUXEval to the keywords field, so that the UX team,
deciding on improvements, finds your proposal easily.





--
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] simplifying documentation

2017-07-28 Thread Cathy Crumbley

Thanks for your input. These is much to learn!

I am referring to the LibreOffice download page. Why? Because it sounds 
like I am not the only one who is unaware that we need to download a 
separate file for the Help files. It should be a relatively simple fix 
to just re-word what is on that page so that people understand.  It is 
puzzling that this has not been done since people are aware of the problem.


I can see what is on the wiki. However, Olivier said "But it requires 
permanent reordering and addition/deletion/update of hundreds of pages, 
permanently." I was trying to understand if he was saying that it is not 
a great source of information. In any case, it sounds like it is the 
only place to get an overview of LibreOffice (although it is still 
challenging to do so).


From your description of Pootle, I was able to learn that an online 
version of LibreOffice is in the works. I don't really understand the 
rest of it, but at least I now know that Pootle is related to that project.


On 7/28/2017 4:41 AM, Sophie wrote:

Hi Cathy,
Le 27/07/2017 à 21:55, Cathy Crumbley a écrit :

Hi Olivier,

Thanks again for the responses.

If this has been a problem for a while, I am puzzled about why it has
not been fixed. Are you aware of a reason why the download page cannot
be re-worded now?

It depends on which download page you're talking about. The download
page on the main website is reworked by infrastructure, design and
marketing project, together with the donate page. It's currently being
improved before being translated. For the download page of the
documentation project, the page is quite new, and maybe no volunteer had
time to work on it for the moment.

To be clear, what are you saying is the best source of information for
people who are new to this and want to learn about the overall
LibreOffice project?  Are you saying that the wiki is not useful because
so much work needs to be done on it?

On the wiki, you'll see the different sub-projects of the LibreOffice
overall project, mainly: development, QA (quality assurance), UX/Design
(user experience), l10n (localization), documentation, infrastructure,
marketing, certification and NLPs (native language projects). All those
sub projects interact together to finally deliver LibreOffice the
product. You'll find also information about the Document Liberation
Project (DLP) which is another project under TDF umbrealla.

As long as I am asking questions, here is one more: What is the Pootle
server?

Pootle is an instance used by the l10n team to localize LibreOffice UI
and Help, part of the website, LibreOffice On Line currently.

Don't hesitate to ask any question you have :)
Cheers
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] simplifying documentation

2017-07-28 Thread Sophie
Hi Cathy,
Le 27/07/2017 à 21:55, Cathy Crumbley a écrit :
> Hi Olivier,
> 
> Thanks again for the responses.
> 
> If this has been a problem for a while, I am puzzled about why it has
> not been fixed. Are you aware of a reason why the download page cannot
> be re-worded now?

It depends on which download page you're talking about. The download
page on the main website is reworked by infrastructure, design and
marketing project, together with the donate page. It's currently being
improved before being translated. For the download page of the
documentation project, the page is quite new, and maybe no volunteer had
time to work on it for the moment.
> 
> To be clear, what are you saying is the best source of information for
> people who are new to this and want to learn about the overall
> LibreOffice project?  Are you saying that the wiki is not useful because
> so much work needs to be done on it?

On the wiki, you'll see the different sub-projects of the LibreOffice
overall project, mainly: development, QA (quality assurance), UX/Design
(user experience), l10n (localization), documentation, infrastructure,
marketing, certification and NLPs (native language projects). All those
sub projects interact together to finally deliver LibreOffice the
product. You'll find also information about the Document Liberation
Project (DLP) which is another project under TDF umbrealla.
> 
> As long as I am asking questions, here is one more: What is the Pootle
> server?

Pootle is an instance used by the l10n team to localize LibreOffice UI
and Help, part of the website, LibreOffice On Line currently.

Don't hesitate to ask any question you have :)
Cheers
Sophie

-- 
Sophie Gautier sophie.gaut...@documentfoundation.org
GSM: +33683901545
IRC: sophi
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] Wiki cleanup

2017-07-28 Thread Sophie
Hi Kenneth

Le 28/07/2017 à 07:04, Kenneth Hanson a écrit :
> I've started to revise and organize parts of the documentation wiki,
> starting with things I think will be uncontroversial. I figure that this is
> a good thing to do while I'm new, since it's obvious to me what is
> confusing or hard to find, but do speak up if I get carried away.

great, thanks for your work :)
> 
> Two major problems that stick out to me:
> 1. There is a large but incomplete duplication of content between the TDF
> wiki, the documentation website, and the main website. I think there needs
> to be a discussion about what should go where.
> 2. There seems to be two very different kinds of content on the TDF
> documentation team sub-wiki: pages for users, and pages for the
> documentation team. On the other hand, there is also miscellaneous info for
> users scattered around other parts of the wiki.

Could you add links to what you're talking about and the duplication you
see, it would be easier to help you.
> 
> Currently it doesn't look like it would be trivial to move the all the
> users-facing wiki pages to the documentation website, so perhaps as a
> temporary solution we could make a separate section or subsection on the
> wiki to collect everything together. I'll think about what to name this
> hypothetical section and wait for other opinions before I do anything.

You can open a discussion page under the documentation project in the
wiki and put the links of the page you want us to discuss, that would be
really helpful
Cheers
Sophie

-- 
Sophie Gautier sophie.gaut...@documentfoundation.org
GSM: +33683901545
IRC: sophi
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] simplifying documentation

2017-07-28 Thread Cor Nouws
Hi Cathy,

Cathy Crumbley wrote on 28-07-17 06:18:

> Just to be clear, I was not expressing problems with the Help files. In
> fact,  I was not even aware that they exist when I wrote this.

In know that you was talking about the user interface. That is what my
comment is about too ;)

> On 7/27/2017 3:52 AM, Cor Nouws wrote:

>> Indeed issues are the proper way to suggest better wording.
>> You may add needsUXEval to the keywords field, so that the UX team,
>> deciding on improvements, finds your proposal easily.


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