On Aug 9, 1:20 pm, "Edward K. Ream" <[email protected]> wrote: > I am beginning to think of documentation as a burden. Not for me, for > the readers. Yes, people do need docs, but the *last* thing they need > is to wade through endless words words words.
There is one rule which, imo, has no significant exceptions. Avoid the !...@#$% passive voice. It just *kills* readability. I don't believe I am responsible for the majority of passive constructions in Leo's docs. Note for doc writers, *whatever* else you do, avoid the passive voice! Edward -- You received this message because you are subscribed to the Google Groups "leo-editor" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/leo-editor?hl=en.
