Re: [libreoffice-documentation] Getting Started 5.1

No: what I mean by "indirect" is changing "you can do x" to "the user can do x". This sort of deflective writing reduces the immediacy of this being information for the person who is reading it right then. On Thu, Apr 7, 2016 at 6:38 PM, Dennis E. Hamilton wrote: > > >

Re: [libreoffice-documentation] Problems editing help files

Hi Peter Em 07/04/2016 15:23, ptoye escreveu: > I'm trying for the first time to edit a live help file and have come up > against a few problems. *WARNING* I'm a Git virgin so please treat me > kindly. Git is the best tool for those who tamed it. > > Firstly, the Git tutorials that I've found

[libreoffice-documentation] Problems editing help files

I'm trying for the first time to edit a live help file and have come up against a few problems. *WARNING* I'm a Git virgin so please treat me kindly. Firstly, the Git tutorials that I've found assume that all files are in a single one-level directory structure. Easy for teaching, but not for real

Re: [libreoffice-documentation] Getting Started 5.1

Hello You are right. You must be talking about the Preface. Track changes accept/reject filtered by author is your friend to put the text on track. also for quick communication, we have an IRC channel for documentation: in freenode, access #libreoffice-doc https://webchat.freenode.net/ regards

Re: [libreoffice-documentation] Getting Started 5.1

That is good to know. However, in the material I am looking at, the edits do not seem to follow the style guide. The edits move from active to passive voice and from direct to indirect speech.

Re: [libreoffice-documentation] Getting Started 5.1

Hello Andrew, All In ODF Authors site, you can get the writing style guide in Home / LibreOffice / English / Resources for Contributors / Ch5 Style Guide I think it worth to all authors to follow it. Exerpt: Writing style The following list summarizes our preferred writing style. Some of

Re: [libreoffice-documentation] Getting Started 5.1

I am also uncomfortable with the change from active to passive voice. Passive voice is harder to read and to understand, expecially for those for whom English is not the first language. On Thu, Apr 7, 2016 at 11:00 AM, Andrew Wetmore wrote: > I said this to Oliver directly,

Re: [libreoffice-documentation] Getting Started 5.1

I said this to Oliver directly, forgetting to "reply all": I don't think it's a good idea to move away from immediacy ("you") to a more remote tone ("the user"). This goes contrary to current trends in documentation. On Thu, Apr 7, 2016 at 10:45 AM, Hazel Russman

Re: [libreoffice-documentation] Getting Started 5.1

On Thu, 7 Apr 2016 10:59:01 -0300 Olivier Hallot wrote: > Hello > > In the last weeks I updated the first 4 chapters of the 5.0 Getting > Started book to the 5.1 version and placed them in the 5.1 Draft > folder for revision. The files are with Track changes

Re: [libreoffice-documentation] Getting Started 5.1

I just made them "publish internally", which I think will make them available once logged in... Em 07/04/2016 11:03, Andrew Wetmore escreveu: > I see the folder, but no files. -- Olivier Hallot Comunidade LibreOffice http://ask.libreoffice.org/pt-br -- To unsubscribe e-mail to:

Re: [libreoffice-documentation] Getting Started 5.1

I see the folder, but no files. On Thu, Apr 7, 2016 at 9:59 AM, Olivier Hallot < olivier.hal...@libreoffice.org> wrote: > Hello > > In the last weeks I updated the first 4 chapters of the 5.0 Getting > Started book to the 5.1 version and placed them in the 5.1 Draft folder > for revision. The

[libreoffice-documentation] Getting Started 5.1

Hello In the last weeks I updated the first 4 chapters of the 5.0 Getting Started book to the 5.1 version and placed them in the 5.1 Draft folder for revision. The files are with Track changes enabled so it will be easy to see the changes. The contents addition are moderately deep in details,