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

Hi Tom, Tom Davies píše v St 16. 12. 2015 v 19:15 +: > 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 that only exists in English. For all other languages > it is, beyond doubt,

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

Þann fim 17.des 2015 03:43, skrifaði 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"

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

I'll send you a PDF. My book is more than personal opinion, being based on research by numerous people over many years. It has been used in technical writing courses and may still be in use, although it is out of print. --Jean On Thursday, December 17, 2015, Lera wrote:

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

Free copy of PDF available here: http://www.jeanweber.com/newsite/wp-content/uploads/ITHH_Ebook.pdf On Thu, Dec 17, 2015 at 7:14 PM, Jean Weber wrote: > I'll send you a PDF. My book is more than personal opinion, being based on > research by numerous people over many years.

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

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

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] Help-files: Large-scale 'cosmetic' changes

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

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