Style notes

From rejetto wiki
Revision as of 08:19, 27 October 2006 by Peterh (talk | contribs)
Jump to navigation Jump to search

In general terms, we follow Microsoft guidelines for terminology, as detailed in:
Microsoft® Computer Dictionary, Fifth Edition (Microsoft Press, 05/01/2002).
This establishes basic meanings, spellings and wordforms.

Unfortunately, this has not been updated for more than five years although MicroSoft (MS) terminology changes almost as often as they issue software patches.

More recent glossaries can be accessed through http://www.microsoft.com/resources/glossary/default.mspx.


Some exceptions are noted below:

We use ie. (NOT i.e.) for "that is", and eg. (NOT e.g.) "for example". This violates Microsoft documentation standards, but we like to live dangerously.

We also use etc. as an abbreviation for "et cetera" (it means "and so on"). Curiously, this also violates MS standards, but you'll find many examples of this in their software and documentation.

Like MS, we use both "System tray" and "Notification area" as the name of the right-hand section of the Taskbar that normally includes the clock. (If anyone's actually interested, there's a whole debate about it [here].)


<html><head><title>Rules</title> <meta name="GENERATOR" content="GemX TexNotes Pro 4.3"></head> <body bgcolor="#ffffff" leftmargin=5 topmargin=5 rightmargin=5 bottommargin=5>

Overcoming blocks
Rules are always controversial. But all writers need these things to cling to.
The following rules make a good litmus test. In general, if you can understand how these sentences break the very rules they promote, most of the material Phnote> will be familiar to you.
The point of many of these sentences is very hard to understand for those who use English as their second language, but mostly obvious to educated natives.
Writer's Rules, OK ?

These rules are normally attributed to William Safire, "the most widely read writer on the English language".
01. Remember to never split an infinitive.
02. The passive voice should never be used.
03. Do not put statements in the negative form. 
04. Verbs have to agree with their subjects. 
05. Proofread carefully to see if you words out.
06. If you reread your work, you can find on rereading a great deal of repetition can be avoided by rereading and editing.
07. A writer must not shift your point of view.
08. And don't start a sentence with a conjunction. 
09. Remember, too, a preposition is a terrible word to end a sentence with.)
10. Don't overuse exclamation marks !!
11. Place pronouns as close as possible, especially in long sentences, as of 10 or more words, to their antecedents.
12. Writing carefully, dangling participles must be avoided.
13. If any word is improper at the end of a sentence, a linking verb is.
14. Take the bull by the hand and avoid mixing metaphors. 
15. Avoid trendy locutions that sound flaky.
16. Everyone should be careful to use a singular pronoun with singular nouns in their writing.
17. Always pick on the correct idiom.
18.The adverb always follows the verb.
19. Last but not least, avoid clichés like the plague; seek viable alternatives.
Life

Unfortunately, life and writing are seldom simple, and despite its obvious brilliance, (7,12,17 in particular) Safire's list has attracted some criticism. 
4 is particularly controversial, 5 & 6 might be combined, 9 could be "improved" by putting the period outside the bracket, etc.
Never use a preposition to end a sentence with.
*
       Avoid anoying alliteration.
*
       Don't verb nouns.
*
       Don't use no double negatives.
*
       Make each pronoun agree with their antecedent.
*
       When dangling, watch your participles.
*
       Don't use commas, which aren't necessary.
*
       Verbs has to agree with their subjects.
*
       About those sentence fragments.
*
       Try to not ever split infinitives.
*
       Its important to use apostrophe's correctly.
*
       Always read what you have written to see if you've any words out.
*
       Correct spelling is esential.
*
       Proofread you writing.
*
       Between you and I, case is important.
*
       Verbs has to agree with their antecedents.


George Orwell

George Orwell 1946 reckoned that writers "need rules to rely on when instinct fails". He proposed the following rules. (Slightly modernized here.)
1. Never use a long word where a short one will do.
2. If you can cut a word out, always cut it out.
3. Never use the passive where you can use the active.
4. Never use a foreign phrase or jargon if there is an everyday English equivalent.
5. Never use a metaphor that has become a cliché from overuse.
6. Break any rule rather than say anything outright barbarous.
Mark Twain

Mark Twain wrote (in a letter):
"I notice you use plain simple, language, short words, and brief sentences. That is the way to write English."
Fumble-rules

William Safire, winner of the 1978 Pulitzer Prize for distinguished commentary, joined The New York Times in April 1973 as a political columnist. He also writes a Sunday column, "On Language," which has appeared in The New York Times Magazine since 1979. This column on grammar, usage, and etymology has led to the publication of 10 books and made him the most widely read writer on the English language.

This list was originally compiled by George L. Trigg et. al. The Writing Center got this copy from ILS 3, who took it from Optics News Vol. 8: No. 1, which had reprinted it from Phys. Rev. Lett. 42:748 (1979).

   1. Make sure each pronoun agrees with their antecedent.
   2. Just between you and I, the case of pronouns is important.
   3. Watch out for irregular verbs which have crope into English.
   4. Verbs has to agree in number with their subjects.
   5. Don't use no double negatives.
   6. Being bad grammar, a writer should not use dangling modifiers.
   7. Join clauses good like a conjunction should.
   8. A writer must not shift your point of view.
   9. About sentence fragments.
  10. Don't use run-on sentences you got to punctuate them.
  11. In letters essays and reports use commas to separate items in a series.
  12. Don't use commas, that are not necessary.
  13. Parenthetical words however should be enclosed in commas.
  14. Its important to use apostrophes right in everybodys writing.
  15. Don't abbrev.
  16. Check to see if you any words out.
  17. In the case of a report, check to see that jargonwise, it's A-OK.
  18. As far as incomplete constructions, they are wrong.
  19. About repetition, the repetition of a word might be real effective repetition—take, for instance the repetition of Abraham Lincoln.
  20. In my opinion, I think that an author when he is writing should definitely not get into the habit of making use of too many unnecessary words that he does not really need in order to put his message across.
  21. Use parallel construction not only to be concise but also clarify.
  22. It behooves us all to avoid archaic expressions.
  23. Mixed metaphors are a pain in the neck and ought to be weeded out.
  24. Consult the dictionery to avoid mispelings.
  25. To ignorantly split an infinitive is a practice to religiously avoid.
  26. Remember to hyphenate two or more word modifiers that precede the words they modify.
  27. Last but not least, lay off cliches. 
And one more favorite of mine that Trigg left off his list:
28. Eschew obfuscation!! 

Since the 1970s at least, lists of humorous rules for writing have circulated around schools, universities, and offices. The humor depends on each rule contradicting the very advice it gives, such as "Don't use no double negatives."

As Mark Israel's FAQ states, these were written up by William Safire under the name "Fumblerules," although there is at least one earlier published source of a similar list, by science editor George L. Trigg. Below, I give details about both of those sources, and quote the original articles in full.

Note that both Trigg and Safire credit others with having collected or contributed the rules they published. Although they helped in publicizing this catchy form, neither should be considered the originator.

There are many, many variants of these lists on the World Wide Web. Some clearly began with one list or the other and added new ones as people thought of them. Others may have descended from the same "xeroxlore" that preceded both and circulated throughout campuses and offices in the 1970s. You can turn these up by searching on typical phrases like "don't use no double negatives" (which appears in both original articles) and "eschew obfuscation" (which appears in neither).

George L. Trigg "Grammar"

The following is the text of an article in the scientific journal Physics Review Letters, 19 March 1979 (Volume 42, Issue 12, pp. 747-748).
Grammar

It is said that back in the 1940's, the following message was prominently displayed at the front of the main chemistry lecture hall at a major university:

"The English language is your most versatile scientific instrument. Learn to use it with precision."

In the intervening years, the teaching of proper grammar in the public elementary and high schools fell into disfavor. The inevitable result is that manuscripts submitted to us are often full of grammatical errors, which their authors probably do not even recognize (and often would not care about if they did).

We regard this state of affairs as deplorable, and we want to do something about it. For many years we have tried to correct the grammar of papers that we publish. This is toilsome at best, and sometimes entails rather substantial rephrasing. It would obviously be preferable to have authors use correct grammar in the first place. The problem is how to get them to do it.

One fairly effective way is to provide examples of what not to do; it is particularly helpful if the examples are humorous. We have recently seen several lists of grammatical examples of this type. A few weeks ago we found taped to a colleague's office door the most complete one we have seen. (He tells us it was passed out in a class of Darthmouth - not in English - at the time a term paper was assigned). We reproduce it here in the hope that it will have some effect.

   1. Make sure each pronoun agrees with their antecedent.
   2. Just between you and I, the case of pronoun is important.
   3. Watch out for irregular verbs which have crope into English.
   4. Verbs has to agree in number with their subjects.
   5. Don't use no double negatives.
   6. Being bad grammar, a writer should not use dangling modifiers.
   7. Join clauses good like a conjunction should.
   8. A writer must be not shift your point of view.
   9. About sentence fragments.
  10. Don't use run-on sentences you got to punctuate them.
  11. In letters essays and reports use commas to separate items in series.
  12. Don't use commas, which are not necessary.
  13. Parenthetical words however should be enclosed in commas.
  14. Its important to use apostrophes right in everybodys writing.
  15. Don't abbrev.
  16. Check to see if you any words out.
  17. In the case of a report, check to see that jargonwise, it's A-OK.
  18. As far as incomplete constructions, they are wrong.
  19. About repetition, the repetition of a word might be real effective repetition - take, for instance the repetition of Abraham Lincoln.
  20. In my opinion, I think that an author when he is writing should definitely not get into the habit of making use of too many unnecessary words that he does not really need in order to put his message across.
  21. Use parallel construction not only to be concise but also clarify.
  22. It behooves us all to avoid archaic expressions.
  23. Mixed metaphors are a pain in the neck and ought to be weeded out.
  24. Consult the dictionery to avoid mispelings.
  25. To ignorantly split an infinitive is a practice to religiously avoid.
  26. Last but not least, lay off cliches.

The above was taken from a reprint at <a href="http://lib.ru/ANEKDOTY/orfograf.txt">http://lib.ru/ANEKDOTY/orfograf.txt</a>.


William Safire "Fumblerules"

In the same year, William Safire wrote at the end of his "On Language" column in the New York Times, on 7 October 1979:

Query:

I am compiling "Ten Perverse Rules of English Grammar." Thanks to Philip Henderson of Lawrence, Kan., I have three. They are: (1) Remember to never split an infinitive. (2) A preposition is something never to end a sentence with. (3) The passive voice should never be used.

Any others along these lines?

He followed this up a month later, on 4 November 1979, with the following "On Language" column:
The Fumblerules of Grammar

Not long ago, I advertised for perverse rules of grammar, along the lines of "Remember to never split an infinitive" and "The passive voice should never be used." The notion of making a mistake while laying down rules ("Thimk," "We Never Make Misteaks") is highly unoriginal, and it turns out that English teachers have been circulating lists of fumblerules for years.

As owner of the world's largest collection, and with thanks to scores of readers, let me pass along a bunch of these never-say-neverisms:

    * Avoid run-on sentences they are hard to read.
    * Don't use no double negatives.
    * Use the semicolon properly, always use it where it is appropriate; and never where it isn't.
    * Reserve the apostrophe for it's proper use and omit it when its not needed.
    * Do not put statements in the negative form.
    * Verbs has to agree with their subjects.
    * No sentence fragments.
    * Proofread carefully to see if you any words out.
    * Avoid commas, that are not necessary.
    * If you reread your work, you will find on rereading that a great deal of repetition can be avoided by rereading and editing.
    * A writer must not shift your point of view.
    * Eschew dialect, irregardless.
    * And don't start a sentence with a conjunction.
    * Don't overuse exclamation marks!!!
    * Place pronouns as close as possible, especially in long sentences, as of 10 or more words, to their antecedents.
    * Hyphenate between sy-
      llables and avoid un-necessary hyphens.
    * Write all adverbial forms correct.
    * Don't use contractions in formal writing.
    * Writing carefully, dangling participles must be avoided.
    * It is incumbent on us to avoid archaisms.
    * If any word is improper at the end of a sentence, a linking verb is.
    * Steer clear of incorrect forms of verbs that have snuck in the language.
    * Take the bull by the hand and avoid mixed metaphors.
    * Avoid trendy locutions that sound flaky.
    * Never, ever use repetitive redundancies.
    * Everyone should be careful to use a singular pronoun with singular nouns in their writing.
    * If I've told you once, I've told you a thousand times, resist hyperbole.
    * Also, avoid awkward or affected alliteration.
    * Don't string too many prepositional phrases together unless you are walking through the valley of the shadow of death.
    * Always pick on the correct idiom.
    * "Avoid overuse of 'quotation "marks."'"
    * The adverb always follows the verb.
    * Last but not least, avoid cliches like the plague; seek viable alternatives.
Note:

</body></html>