Monday, November 15, 2004

abstract from "Bugs in writing"

The principles of lucid writing:
You should avoid using passive voice in your writing; you should instead use active voice and should name your agents.

You should distinguish the three terms so, so that, and such that , so that you write more accurately, such that you use words correctly, so you feel confident when you publish your document.

you should use the terms between, eatch other, either, and a couple to refer to precisely two entiteis; and you should use the term among, one another, any one of, and several to refer to more than two entities.

Max only ate breakfast; he did not throw it on the floor.

you should never attempt to motivate any entity that is not a living creature.

You should consider organizing your presentation based on key terms, which are terms critical to the meaning of yor discussion; that you should usually define key term in text; and that you should use a form of typographical distinction to highlight key terms.

We have proved that you should use proven only as a modifier

You should understand that none can mean not any or not one. If your phrase would be recast as none of them, then you should use plural form of the verb; if the phrase would be recast as none of it, then you should use a singular verb

You should use a colon at the end of a sentence to indicate that further explanation follows: An explanation might consist of detailed list, for example, or of an example

Important!
You should use that to identify objects (which may be creatures), and should use which to make remarks that provide extra information about objects
1. does the clause identify the object under discussion (that), or does it merely add information (which)?
2. does the clause pick out one among possibly many like objects (that), or is there only one such object under discussion (which)?
3. does the clause contribute information critical to the meaning of the sentence (that), or is the contribution more in the nature of a parenthetical remark (which)?
4. should the clause be left without commas (that), or should it be set off by commas (which)?

0 Comments:

Post a Comment

<< Home