[libreoffice-documentation] Help-files: Large-scale 'cosmetic' changes

2015-12-16 Thread Tom Davies
Hi :) Again i am asking for advice and suggestions. I don't know the best way to handle this or even if there is a real problem here or not. It is about the Help Files. The Documentation Team may be able to make some much-needed changes to the help-files. However, it is to solve a problem

Re: [libreoffice-documentation] Help-files: Large-scale 'cosmetic' changes

2015-12-16 Thread Jean Weber
I disagree, and in fact I wrote a book on the topic (Is the Help Helpful). For Help to be helpful, it often should not be purely functional but also task-oriented description of what the user can or should do to achieve a goal or complete a task. Jean Weber On Thu, Dec 17, 2015 at 1:43 PM, Lera

Re: [libreoffice-documentation] Video Tutorial Link in Help

2015-12-16 Thread Tom Davies
Hi :) There are some video tutorials at; http://spoken-tutorial.org/ They cover many different OpenSource programs so if you scroll down the first drop-down you will see quite a few done for LibreOffice. The 2nd drop-down allows people to change to a lot of different languages, although no

Re: [libreoffice-documentation] Help-files: Large-scale 'cosmetic' changes

2015-12-16 Thread Lera
Hi, It is a bad idea to describe the actions of the user in the Help. The Help (as documentation) should describe only the functionality of the program, but it is not something that the user can (should) do. Therefore, the words "you", "your", "user" should be used with extreme caution. Almost

Re: [libreoffice-documentation] Help-files: Large-scale 'cosmetic' changes

2015-12-16 Thread Lera
Hi Jean Weber, В письме от 17 декабря 2015 15:10:40 пользователь Jean Weber написал: > I disagree, and in fact I wrote a book on the topic (Is the Help > Helpful). I will read your book, if I can find it in free access. I am always happy to learn something new. But during about 20 years of