Help:Style guide/A-Z

From the Portal Wiki
< Help:Style guide
Revision as of 20:49, 22 April 2011 by RJackson (talk | contribs) (CopypasteCopypasteCopypaste)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Template:Help navbar

A

A or an?
Use an before a silent H: an hour, an heir, an honourable man, an honest woman; a hero, a hotel, a historian (but don't change a direct quote if the speaker says, for example, "an historic"). With abbreviations, be guided by pronunciation: eg an LSE student
Abbreviations and acronyms
Use all capitals if an abbreviation is pronounced as the individual letters: BBC, VAT etc; if it is :an acronym (pronounced as a word) spell out with initial capital, eg Nasa, Nato, unless it can be considered to have entered the language as an everyday word, such as awol, laser and, more recently, pin and sim card.
If an abbreviation or acronym that readers may not immediately recognize is to be used more than once, put it in brackets at first mention, eg Association of Chief Police Officers (Acpo), seasonal affective disorder (Sad). This saves people having to search back through the article to find the original reference.
Use common sense, however: it is not necessary to spell out well-known ones, such as EU, UN, CIA, FBI, CD, Nasa, etc.
Cap up single letters in such expressions as C-list, F-word, "the word assassin contains four Ss", etc
Adverbs
Do not use hyphens after adverbs ending in -ly, eg a hotly disputed penalty, a constantly evolving world, genetically modified food, etc; but hyphens are needed with short and common adverbs, eg ever-forgiving family, ill-prepared report, much-loved character, well-founded suspicion.
Affect/effect
Affect and effect have no senses in common. As a verb affect is most commonly used in the sense of "to influence" (how smoking affects health). Effect (noun) means "to bring about or execute": layoffs designed to effect savings. Thus the sentence These measures may affect savings could imply that the measures may reduce savings that have already been realized, whereas These measures may effect savings implies that the measures will cause new savings to come about.[1]
American/British English
Both American and British English are proper. However, a page should remain consistent throughout in regard to its use of one or the other. For instance, "defence" and "defense" are both correct spellings of the word, and both are acceptable. Regardless, no page should have occurrences of both "defence" and "defense" on it.
Apostrophes
Indicate a missing letter or letters (can't, we'd) or a possessive (David's book).
Contractions can affect the tone of an article and make it appear informal and even inelegant: "what's more" may work but "what is more" may be more appropriate.
The possessive in words and names ending in S normally takes an apostrophe followed by a second S (Jones's, James's), but be guided by pronunciation and use the plural apostrophe where it helps: :Mephistopheles', Waters', Hedges' rather than Mephistopheles's, Waters's, Hedges's.
Plural nouns that do not end in S take an apostrophe and S in the possessive: children's games, old folk's home, people's republic etc.
Phrases such as butcher's knife, collector's item, cow's milk, goat's cheese, hangman's noose, writer's cramp etc are treated as singular.
Use apostrophes in phrases such as two days' time, 12 years' imprisonment and six weeks' holiday, where the time period (two days) modifies a noun (time), but not in nine months pregnant or three weeks old, where the time period is adverbial (modifying an adjective such as pregnant or old) -if in doubt, test with a singular such as one day's time, one month pregnant.
As or since?
"As" is causal: I cannot check the online style guide as the connection is down.
"Since" is temporal: Luckily, I have had the style book on my desk since it was published.
Average, mean and median
Although we loosely refer to the "average" in many contexts (eg pay), there are two useful averages worth distinguishing.
What is commonly known as the average is the mean: everyone's wages are added up and divided by the number of wage earners. The median is described as "the value below which 50% of employees fall" ie it is the wage earned by the middle person when everyone's wages are lined up from smallest to largest. (For even numbers there are two middle people, but you calculate the mean average of their two wages.)
The median is often a more useful guide than the mean, which can be distorted by figures at one extreme or the other.

C

Colon
Use between two sentences, or parts of sentences, where the first introduces a proposition that is resolved by the second, eg Fowler put it like this: to deliver the goods invoiced in the preceding words.
A colon should also be used (rather than a comma) to introduce a quotation: "He was an expert on punctuation," or to precede a list - "He was an expert on the following: the colon, the comma and the full stop."
This, is an example of the tendency to use a semi-colon where only a colon will do: "Being a retired soap 'treasure' must be a bit like being in the army reserves; when a ratings war breaks out, it's time to dust off your uniform and wait by the phone."
There is a distinction between colon and semicolon; many writers seem to think they are interchangeable but to make it clear: they are not.
(see semicolon)
Commas
A misplaced comma can sabotage a sentence, as in this example: "Neocon economists often claim a large, black economy turbo-powers growth ..." (the writer was talking about a big black economy, not a big and black one, which is not the same)
Contractions
Do not overuse contractions such as aren't, can't, couldn't, hasn't, don't, I'm, it's, and there's; while they might make a piece more colloquial or easier to read, they can be an irritant and a distraction, and make a serious article sound frivolous.

H

Hyphens
Use one word wherever possible, hyphens tend to clutter up text (particularly when the computer breaks already hyphenated words at the end of lines).
Inventions, ideas and new concepts often begin life as two words, then become hyphenated, before finally becoming accepted as one word. Why wait? "Wire-less" and "down-stairs" were once hyphenated.
Words such as handspring, madhouse and talkshow are all one word, as are thinktank (not a tank that thinks), longlist (not necessarily a long list) and shortlist (which need not be short).
Prefixes such as macro, micro, mega, mini, multi, over, super and under rarely need hyphens: examples are listed separately. Follow http://www.dictionary.com when a word or phrase is not specifically listed in this guide.
There is no need to use hyphens with most compound adjectives, where the meaning is clear and unambiguous without: civil rights movement, financial services sector, work inspection powers etc.
Hyphens should, however, be used to form short compound adjectives, eg two-tonne vessel, stand-up comedian, three-year deal, 19th-century artist, etc.
Also use hyphens where not using one would be ambiguous, eg to distinguish "black-cab drivers come under attack" from "black cab-drivers come under attack".
Do not use hyphens after adverbs ending in -ly, eg politically naive, wholly owned, but when an adverb is also an adjective (eg hard), the hyphen is required to avoid ambiguity- it's not a hard, pressed person, but a hard-pressed one; an ill-prepared report, rather than an ill, prepared one.
Use hyphens with short and common adverbs: much-needed grammar lesson, well-established principle of style (note though that in the construction "the principle of style is well established" there is no need to hyphenate)

I

If not
Can be ambiguous: does "it is the most beautiful castle in France, if not the whole of Europe" mean "and maybe in the whole of Europe" or "but not in the whole of Europe"?
Into or in to?
One word if you go into a room, but two words in such sentences as "I called in to complain", "I listened in to their conversation" and "I went in to see my friend".
It's or its
"It's" is the shortened form of it is or it has: it's a big dog; it's been ages since I saw her. "Its" is the possessive form of it: the dog is eating its bone.

L

Learned
Not learnt, unless you are writing old-fashioned poetry (he learned his tables, a message well learned, etc)

M

May or might?
"May" implies that the possibility remains open whereas "might" suggests that the possibility remains open no longer. "They may have played tennis, or they may have gone boating" suggests I don't know what they did; "they might have played tennis if the weather had been dry" means they didn't, because it wasn't.

N

No doubt that, no question that
Are opposites: "There was no doubt that he was lying" means he was lying; "There was no question that he was lying" means he wasn't, although the two are routinely confused.
No one
Not no-one.
Numbers
When used within a sentence, spell out from one to nine; integers from 10 to 999,999; thereafter use m or bn for sums of money, quantities or inanimate objects in copy, eg £10m, 5bn tonnes of coal, 30m doses of vaccine; but million or billion for people or animals, eg 1 million people, 3 billion rabbits, etc; spell trillion in full at first mention, then tn; in headlines use m, bn or tn.

P

Pronunciation
If a word is difficult to pronounce and the correct pronunciation isn't something most people know, or the word is not part of the English language then the correct IPA pronunciation (if not English) or Merriam-Webster pronunciation (if English or a place name) should be provided along with a recording of the word being said clearly and correctly.
Leave some silence at the end of a recording for browsers and players which truncate sound files.

Q

Quotation marks
Use double quotes at the start and end of a quoted section, with single quotes for quoted words within that section. Place full points and commas inside the quotes for a complete quoted sentence; otherwise the point comes outside:
"Anna said, 'Your style guide needs updating,' and I said, 'I agree.' "
but: "Anna said updating the guide was 'a difficult and time-consuming task'."
When beginning a quote with a sentence fragment that is followed by a full sentence, punctuate according to the final part of the quote, eg The minister called the allegations "blatant lies. But in a position such as mine, it is only to be expected."
For parentheses in direct quotes, use square brackets.

R

Re or re-?
Use re- (with hyphen) when followed by the vowels e or u (not pronounced as "yu"): eg re-entry, re-examine, re-urge
Use re (no hyphen) when followed by the vowels a, i, o or u (pronounced as "yu"), or any consonant: eg rearm, rearrange, reassemble, reiterate, reorder, reuse, rebuild, reconsider
Exceptions: re-read; or where confusion with another word would arise: re-cover/recover, re-form/reform, re-creation/recreation, re-sign/resign

S

Self-control, self-defense, self-esteem, self-respect
Hyphenated
Semicolon
Used correctly, the semicolon is a very elegant compromise between a full stop (too much) and a comma (not enough). "Some reporters were brilliant; others were less so".

T

That or which?
"That" defines, "which" informs:
This is the house that Jack built, but this house, which John built, is falling down.
This and that
That was then, but this is now; this looks forward, that looks back: so the man showing his son and heir the lands lying in front of them says: "One day, son, all this will be yours." Then he points behind him to the house and says: "But that remains mine".

Y

y or ie?
As a general rule: -y is an English suffix, whose function is to create an adjective (usually from a noun, eg creamy); -ie was originally a Scottish suffix, whose function is to add the meaning of "diminutive" (usually from a noun, eg beastie).
So in most cases, where there is dispute over whether a noun takes a -y or an -ie ending, the correct answer is -ie: she's a girly girl, but she's no helpless girlie. Think also scrunchie, beanie, nightie, meanie ... There are exceptions (a hippy, an indie band), but where specific examples are not given, use -ie for nouns and -y for adjectives.

Z

Zigzag
no hyphen