User:Tony1/How to satisfy Criterion 1a

From Wikipedia, the free encyclopedia

Featured content:

Featured article tools:

The featured article criteria are demanding requirements to ensure that featured articles (FAs) are of the highest quality. The criteria have a powerful impact on Wikipedia, because FAs set the standards for all articles. Criterion 1a states that FAs are “well written”: that the prose is “compelling, even brilliant”. For many contributors, this is the most challenging aspect of preparing a FA candidate (FAC). Unlike such tasks as neutralising POV, adding inline references and justifying the copyright status of images, identifying and fixing suboptimal prose requires skill and experience typically acquired only after years of writing and editing. Wikipedia flourishes through the input of your expertise, yet the FAC process shows that the prose of many articles does no justice to that expertise. You can pursue three strategies to satisfy 1a.

  • Improve your article in direct response to the comments of FAC reviewers.
This sometimes works, but it’s typically hard to achieve significant improvements in the short time allowed for the review process. Reviewers are under no obligation to specify every problem in the prose of a FAC, or to edit a FAC themselves.
  • Network with other Wikipedians who are interested in the topic and who are skilled at editing prose, and request input from them (preferably before nomination).
Wikipedia comprises numerous communities of like-minded users. List yourself in one or more categories relevant to your own fields, and research the talk pages and contribution lists of other users in those categories. Aim to build a circle of friends through discussion and mutual assistance. Becoming active in one of Wikipedia's many subject-based projects may help you find contributors who can assist you by copy-editing your article during peer review and before FAC nomination. Alternatively, research the FAC archives and the history pages of good articles in the field; identify reviewers and contributors who’ve successfully worked on those articles. Posting a polite message requesting help on one or more users’ talk pages often works wonders. In your message, show that you’re familiar with their work. We've provided more information on how to find good copy-editors here, but please remember that there will always be a shortage of good copy-editors on Wikipedia.
  • Improve your own writing/editing skills.
This is the concern of this article, which offers general advice on how to improve your writing/editing skills, lists the common problems that reviewers identify in the prose of FACs, and discusses strategies for avoiding those problems. The advice in most areas is followed by a link to a set of exercises, for which hints and suggested solutions are displayed at the touch of a button. The material for these exercises is drawn from past FACs. We hope that working through the exercises sets you on a path towards improving your writing/editing skills.

This article is aimed at both native and non-native speakers of English, although the groups face different challenges in writing and editing English; most issues we cover are also applicable to many languages. The advice here complements the information in Great writing, The perfect article, Featured article advice, User:AndyZ/Suggestions and User:Jengod/Some common objections to featured status and how to avoid them. At the end of this article, we provide useful external links for writing and editing.

While most criteria for good writing in English are widely accepted, its advocates may differ on particular technical and stylistic matters. Please take this into account here: some of our advice and suggested solutions may be debatable. Feedback is welcome on our talk page on how to improve this article. We acknowledge assistance in the copy-editing of this article by Hoary.


Computers have transformed the writing process by facilitating continual editing; this frees writers from the need to produce a succession of entire versions on a typewriter or by hand.
Enlarge
Computers have transformed the writing process by facilitating continual editing; this frees writers from the need to produce a succession of entire versions on a typewriter or by hand.

Contents

[edit] Making the best use of your existing skills

[edit] Attaining “strategic distance”

It may seem counterintuitive, but the very closeness to a text that comes with working on it intensively can inhibit your ability to appraise it. This is why other people may immediately see problems and errors in your text that eluded you, even though you may be a superior writer. Editing a text as a stranger has distinct advantages, chiefly the ability to approach it with fresh eyes, unaffected by the intricacies of creating it in the first place.

You can attain “strategic distance” from your own text by using techniques that allow you to see it differently. These involve visual appearance, the editing process and the passing of time.

Wikipedia provides one method for doing this: the “Show preview” function lets you see your text as a finished product on the monitor before you save it. The difference between this and what you see in the edit box distances you from the process of writing or editing the text, and highlights the need for further improvements. Beyond this, here are some suggestions that work well for many writers; try them and see which ones work for you.

  • Print out your text and mark up the hard copy (highlight the places that need improvement, by circling, underlining, and handwriting improved wording in the margins). Reading hard copy is very different from reading off a monitor: the resolution is better, and you can see more text at once (synoptically), grasp the product in your hands, and readily work on it in a different environment. Some writers use a four-stage cycle of printing out a draft, marking it up, keying in the changes and editing the new version on-screen—a cycle they repeat until no further changes are needed. Doing this repeatedly may not suit you, but consider going through the process at least once for each article.
  • Leave your text for a few days or more and return to it fresh; the longer the break, the more strategic distance you’ll achieve.
  • Edit the paragraphs or even the sentences in reverse order.
  • Read each sentence aloud: this can help you to identify where commas should be inserted or removed, and to check that the clauses run smoothly and grammatically.
  • As you read every word or phrase, ask yourself whether it can be removed without damaging the meaning, and whether it has more than one possible meaning. This might seem like hard work at first, but through practice it will become easier.

Some of these methods help us to edit because they break the normal mechanisms that our brains use to make us more efficient readers and writers. Two of these mechanisms[1] are:

  • chunking—the way our brains save effort by processing small pieces of information (e.g. letters) as larger chunks (e.g. words);[2] and
  • automaticity—knowing how to do something so well that you don’t have to think about it, which is usually the result of learning, repetition and practice.[3]

These mechanisms let you raed tihs txet wtihuot mcuh torulbe at all, by cmboinng waht you see on the pgae wtih fmailair, prcdeitalbe prtteans taht you store in your long-term memory. It's little wonder that we let typos slip by, and the same applies to our tendency to gloss over higher-level problems in text. Ironically, suppressing the very mechanisms that we use to increase our capacity for processing language can help us to scrutinise text for problems and to optimise our writing and editing skills. This is the essence of strategic distance.

Typewriters, in general use during the 20th century, made continual editing very laborious.
Enlarge
Typewriters, in general use during the 20th century, made continual editing very laborious.

[edit] Longer-term self-training

Like any proficiency, that in writing and editing comes from years of effort. Most people significantly improve their writing skills until early adulthood. At that point, the “near enough is good enough” frame often takes over; this can seduce us into relaxing the effort that has already brought us to a plateau of basic, everyday literacy typically surpassed only when there is an obvious need for compelling prose. This is a pity, because writing effective, even powerful prose is within the grasp of most educated people, and can bestow considerable advantages in life.

There is strong evidence that sustained effort is more important to the acquisition of expertise than underlying talent, that expertise arises from fine-tuning structures in the long-term memory drawn on in performing a demanding task.[4] It’s a matter of programming an avoidance of common faults in prose so that the patterns of fine and poor prose become near-instinctive. After first becoming aware of the good and bad ways of connecting ideas in a sentence, with practice you’ll come to see poorly constructed sentences in Wikipedia’s articles almost automatically; and by learning to consciously identify and weed out common redundancies, you’ll start to become adept at turning the soggy into the crisp.

Being a Wikipedian involves close engagement with prose, whether through writing, editing or critiqueing. The “10-year rule” suggests that acquiring full expertise in these tasks is not a quick process;[5] but don’t be discouraged: your efforts will reap palpable rewards in a short time, too.

[edit] Wikipedia as training resource

Wikipedia itself is a rich and little-used resource for self-training, because it provides a huge reservoir of text at all stages of transformation (sometimes circuitous) from the raw and verbose into the stylish and easy to read. A good way of focusing your efforts on improving your prose is to compare two versions of a featured article. Here's how to do this:

  • Look in the FA log — for the current month or (via a link on the right of that page) a previous month for the featured-article candidacy discussion of an article that might interest you. These discussions are very varied: look for one in which the article as originally submitted suffered more than token criticism for failing Criterion 1a.
  • Note the date and time of the nomination (the first message in the discussion).
  • Click the title link to go to the article itself. Do not read this.
  • Click the "Page history" link.
  • Locate the version that immediately preceded nomination. Click that link.
  • Read this old version of the article, carefully. Think of all the changes it needs. Better, click "Printable version" and go through a printout with a red pen.
  • Return to the "Page history" and use the “compare” function to compare that version with either the latest version or the one that got the article promoted. Compare your edits with those that were actually made.

Wikipedia being Wikipedia, the new version you selected may have been vandalised or otherwise debased. Use your judgment here. And you may already be a better editor than you think: If you believe that in some places your version surpasses the latest version, go ahead and improve the latter.

Many Wikipedians have skills that would have placed them in the literary elite in medieval times.
Enlarge
Many Wikipedians have skills that would have placed them in the literary elite in medieval times.

The rest of this article deals with specific problems.

[edit] Eliminating redundancy

It’s typical for 10% of the words of a FAC to be redundant: removing these words will not damage the meaning, and in most cases will strengthen it. Crisp, elegant writing demands the elimination of redundancy.

It takes concentrated practice to identify redundancy, but after a while you’ll learn to test every word subconsciously against its context. The questions you need to ask constantly are: “Will the text lose meaning if I remove this?” and “Is there already a word in this sentence that provides the meaning?” As you strengthen your ability to tighten prose, you’ll find many types of redundancy. Here are four:

  • Additive terms — “also”, “in addition”, “moreover”, “furthermore”. Every sentence is additional to its predecessors, but most of us, including otherwise good writers, have got into the habit of sprinkling these terms through our writing, because they give us a vague feeling of adding to the cohesion of the text (the strength with which it all hangs together) or because of the influence of simplistic education. However, only occasionally are these additive words required for textual cohesion; usually the flow is stronger without them.
  • Temporal terms — “over the years”, “currently”, “now”, “from time to time”. Although these are more likely to be required than the additives, often they add nothing to the sense, or are too vague to be useful. “They planned their future response.” (Try the converse: “They planned their past response.”) Often, the tense of the verb is sufficient to convey the temporal sense; e.g., “Mumbai is currently India's leading financial centre”. Here, the present tense of “is” says it all.
  • Vague terms of size, number and proportion—“some”, “a variety/number/majority of”, “several”, “a few”, “many”, “any”, “all”. These items are often too vague to add useful meaning, or their meaning is already conveyed in the rest of the text; e.g., “All seawater is salty”, “A number of laboratory experiments proved the hypothesis”, “She wrote some masterpieces of fine prose”, and “The scheme does not remove any government-funded programs such as Social Security, Medicare and Medicaid”.
  • Words for which the meaning is already assumed by another word in the clause. For example, “Born the youngest child of a Mexican immigrant couple, her talent was apparent from infancy.” Here, “Born” is assumed in the word “child”; therefore the sentence works better without the first word. The first three words in the next example can be removed, because they’re already covered by the word “when”: “In those instances when requests for assistance fall outside Tahirih’s scope, staff members attempt to locate other consultants.” Similarly, tweaking the grammar allows us to dispense with two words in “The Centre has worked to protect women who come from abroad.” Women from abroad have clearly “come” from there.
  • Words for which the meaning is easily recoverable from the context or from general knowlege. For example, “The cigar smoker burns the dried leaves of the tobacco plant but does not inhale the resulting smoke”. We already know that smoke results from the burning of dried tobacco leaves.

You may wish to undertake some or all of the exercises that we have prepared to sharpen your ability to identify redundancy. These exercises use sentences taken from FACs.

[edit] Achieving flow

When you explain something in writing rather than orally, many aspects of language are removed, such as your intonation, pitch, speed, rhythm and bodily gestures. In writing, you need to make up for the absence of those speech signals, so that your readers will be just as engaged with your message as they are when they listen to you: optimising the flow of your writing is an important way of doing this. Flow comprises a number of aspects, from the smallest punctuation mark to the cohesion of the text on a large scale. Flow can make your writing smooth, clear and easy to read; a lack of flow can make it bumpy and disjointed.

Ironically, flow is achieved by manipulating the breaks in the continuity of the text, controlling the structure of your language—the mortar between the bricks large and small. While some aspects of the flow of a particular text will be the subject of widespread agreement by language experts, flow can often be achieved in more than one way; thus, there’s a strong element of personal style in this aspect of writing. Inevitably, the advice that we offer here on flow will be less definitive than our advice for other characteristics of good writing.

Eight centuries ago, writing was such a rare and elaborate skill that it was displayed with great artistry. This Apocalyse manuscript shows St John's writing to the seven churches of Asia.
Enlarge
Eight centuries ago, writing was such a rare and elaborate skill that it was displayed with great artistry. This Apocalyse manuscript shows St John's writing to the seven churches of Asia.

[edit] Paragraphing

Apart from writing your Wikipedia article in sections, paragraphing is the largest scale on which you’ll need to structure your text. A paragraph break allows your readers to tie up the idea that they’ve just read about—to “download” it more deeply into their memory—and to start afresh on a new idea or a new aspect of the same idea. Aim for paragraphs of roughly equal size, without being overly strict in this respect.

Overly long paragraphs make it harder for your readers to stay interested; a mass of grey text will force them to work hard to keep an ever-increasing amount of information active in their working memory as they wade through. In this situation, try to identify a sentence in the middle of the paragraph that appears to be a departure—to offer something new. Make it the first sentence in a new paragraph.

Similarly, short, “stubby” paragraphs tend to break up the prose, interrupting the flow: give your readers the chance to link a number of sentences into a cohesive whole; that will usually be the easiest way for them to absorb your message. Stubby paragraphs are all too common in Wikipedia articles, and reviewers in the FAC room are apt to object to them. Apart from the psychological effect on the readers, one-sentence paragraphs can result in a fragmented visual appearance. A stubby paragraph should typically be either expanded into full ideas or merged smoothly with another paragraph (most often the previous one). Very occasionally, a single-sentence paragraph might be appropriate to emphasise or summarise an idea.

You may wish to try your hand at our exercise in manipulating paragraph length.

[edit] Sentences

Chopping up snakes

Your readers will also want to “tie up” the information on a more frequent, smaller scale: the sentence. Sentences that are too long are too demanding on readers’ working memory: give them opportunities to download what you’ve just told them in convenient chunks. Here’s an example:

The need for a stronger central government with a unified currency and the ability to conduct the affairs of state, such as foreign policy (and that could bind all of the states under negotiated treaties and agreements rather than be undermined by a single state’s refusal to agree to an international treaty) led to the stronger federal government that was negotiated at the Convention.

It is too long and complex; there are too many ideas to be expressed other than in a masterful sentence, yet this sentence has at least three problems:

  • The comma before “such as” looks like the first of a pair surrounding an example; readers scan what follows in vain for the second comma and its announcement of the end of the example.
  • The parenthetical remark is so long that when it finishes readers have forgotten where they were when it started.
  • It’s not obvious what’s modified by the relative clause between the parentheses.

The sentence bends disconcertingly, and readers trying to follow it lose their bearings. It’s what some people call a “snake”, and it needs to be chopped up into manageable portions.

How do we fix this sentence? The first step is to isolate the ideas. There are usually a number of places where we may erect boundaries between these ideas; here’s one attempt.

The need for a stronger central government with a unified currency and the ability to conduct the affairs of state, such as foreign policy (and that could bind all of the states under negotiated treaties and agreements rather than be undermined by a single state’s refusal to agree to an international treaty) led to the stronger federal government that was negotiated at the Convention.

Each of these ideas could stand alone as a sentence. (Since the middle two ideas are particularly close, we could separate them by a semicolon rather than a full-stop.) Let’s try doing this. In our chopped up snake, the four ideas are coloured as above. We’ve added extra bits in black — either through simple deduction to fill in the context (e.g., “the delegates identified”) or to make the sentences cohere (e.g., connectors such as “In particular” and “This” that link back to previous clauses).

The delegates identified the need for a stronger central government with a unified currency and the ability to conduct the affairs of state. In particular, they saw federal control of foreign policy as a way of binding all of the states under negotiated treaties and agreements; until then, foreign policy had frequently been undermined by a single state’s refusal to agree to an international treaty. This led to the negotiation of a stronger federal government at the Convention.

We started with one sentence of 64 words. We’ve transformed this into three sentences that are slightly longer in total: 77 words. The reader has places to pause and consider the ideas, and the text is much easier to read even if it’s a little longer.

We’ve prepared exercises along the same lines, in case you want to practise chopping up long sentences.


The power of writing has changed the world. Here, Mahatma Gandhi writes at Birla House, Mumbai in August 1942, five years before India gained independence from Britain.
Enlarge
The power of writing has changed the world. Here, Mahatma Gandhi writes at Birla House, Mumbai in August 1942, five years before India gained independence from Britain.

Smoothly integrating ideas into a sentence

Just as snakes require too much working memory to read, stubby sentences don’t allow readers to use the full capacity of their working memory; they usually interrupt the flow of the text, resulting in a stop-start effect. To achieve sentences of comfortable length, it is typically necessary to construct them out of more than one idea. These ideas need to be integrated smoothly and logically into the sentence. One of the commonest problems in FACs is sentences in which the ideas are poorly connected.

To integrate ideas into a sentence, we need to ask ourselves whether their relationship is additive, contrastive or causal. Causal relationships are usually obvious, so we’ll deal with these first.


Causal links

There are two types of causal links: forward and backward.

In a forward link, the first statement causes or leads to the second statement. The typical forward connectors are therefore and thus. They’re largely interchangeable, although thus is more at home in technical contexts. Here are examples:

Wikipedia needs to raise the standards of its prose; therefore, we should create infrastructure that enables contributors to improve their writing skills.
Researchers have identified the three genes responsible for this disease, thus paving the way for the development of gene therapy for this disease.

Other forward links, less common because they’re elaborate, are accordingly and for this/these reason(s). Usually avoid them.

In a backward link, the first statement is caused by or led to by the second statement. The typical backward connector is because. Two others—since and as—are often used instead of because, but we discourage this. Since can refer to time back from the present, and as can mean “at the same time as”. Take the following sentence:

Dr Gupta was unaware of the underlying complexities, as she moved with her extended family to Mumbai in 1999.

It’s unclear whether she was unaware because she moved to Mumbai, or whether she was unaware during the move. It’s safer to use because as your causal connector in every case.

The typical placement of the comma is in the direction of causality: after for forward causality; before for backward causality. Although punctuation is usual here in formal registers such as Wikipedia, this can vary. For example, the following sentence is short and punchy, and thus needs no comma:

The President lost the election because he’s a fool.

But lengthen the sentence and a comma may make it easier to read:

The President won the election, because many African-Americans were not permitted to vote and the Supreme Court endorsed the injustice.

A comma is usually unnecessary if the causal link is in the middle of a clause. For example, this sentence:

Thus, the surveys failed to reveal the problem.

could be changed into:

The surveys thus failed to reveal the problem.

Sometimes the causality is obvious; in these cases, you may be able to dispense with an explicit connector altogether, enabled here by the presence of the semicolon:

This FAC suffers from faulty prose throughout; therefore, the nominator should first have identified good copy-editors who are interested in the topic.
Max Liebermann’s The granddaughter, writing (1923): effective literacy training in schools can release the imaginative power of childhood.
Enlarge
Max Liebermann’s The granddaughter, writing (1923): effective literacy training in schools can release the imaginative power of childhood.

If you don’t need a word, don’t use it!


Contrastive links

Typical contrastive links are:

  • but (avoid at the start of a sentence in formal registers)
  • however,
  • although (usually better than though in formal registers)
  • nevertheless/nonetheless, (less common)
  • in/by contrast, (very pointed)


Additive links

The typical additive link is:

  • and

Usually avoid the following additive links:

  • while (ambiguous)
  • as well/as well as, (usually too strong—an amplified version of "and")
  • moreover, (tired and usually redundant)
  • furthermore, (tired and usually redundant)
  • additionally, (ungainly and usually redundant)
  • in addition, (tired and usually redundant)

Academics and technical writers seem to love the last five words in this list; they should know better.


Two poorly used additives on WP

While is a particular problem on Wikipedia. For example:

“Planning” expenditure is allocated to development schemes outlined in the federal government’s plans, while “central” expenditure is allocated to the state governments.

Does the writer want to emphasise that both spending categories occur at the same time? Surely not—here, while is a poor substitute for and; better still, just use a semicolon:

“Planning” expenditure is allocated to development schemes outlined in the federal government’s plans; “central” expenditure is allocated to the state governments.

With as an additive link is another common problem on WP; it’s usually awkward. For example:

There are 10 chapters in the protocol, with the third chapter—International money laundering—aiming to prevent, detect, and prosecute international money laundering and the financing of terrorism.

Ouch. Tweak the grammar to make it:

There are 10 chapters in the protocol; the third chapter—International money launderingaims to prevent, detect, and prosecute international money laundering and the financing of terrorism.


Confusion between additive and contrastive links

This is surprisingly common in FACs. Take the following sentence, which connects two ideas with the commonest contrastive link, but.

She was raised in London and Manchester, but went on to live in Hong Kong.

The second idea doesn’t contradict the first; it just provides additional information. While Hong Kong may be a very different location from London and Manchester, it’s perfectly possible to live in Hong Kong having been raised in the UK. But is wrong here, because it introduces a statement that contradicts the previous statement or that is surprising or unexpected coming after the previous statement. Here, replacing the contrastive link with the most common additive link—and—will fix the problem:

She was raised in London and Manchester, and went on to live in Hong Kong.
Grammar at its worst.
Enlarge
Grammar at its worst.


Additive relationships: how close are the ideas?

When you’re adding ideas together—rather than contrasting them or showing that one leads to the other—the way you integrate them will depend on how close and long they are. There are three basic ways of linking them.

  • A link with and—very close ideas; when combined, the resulting sentence should not be too long.
  • A link with a semicolon—reasonably close ideas; length is not as important.
  • A link with a full-stop—less close ideas, neither of which should be stubby.

The use of these methods is partly a matter of personal style, although there are cases where most readers would prefer one method over the others. Here’s an example of two relatively short ideas:

(1) Most emu species have a grey-brown plumage of shaggy appearance. On close inspection, the shafts and tips of the feathers are black.

Both ideas concern the visual appearance of the birds, specifically that of their feathers. By integrating them into single sentence, we’re making this closeness obvious to the readers, and avoiding the stop–start effect of two short, successive sentences:

(2) Most emu species have a grey-brown plumage of shaggy appearance; on close inspection, the shafts and tips of the feathers are black.

In (2), the semicolon keeps the readers’ minds focused on the same issue: the feathers. In (1), The full-stop suggested that the next sentence would take a different direction, but in (1), it didn’t. The next example shows a good use of the full-stop—the second sentence addresses a different issue, food:

(3) Most emu species have a grey-brown plumage of shaggy appearance. They eat a variety of native and introduced plant species, depending on seasonal availability.

The sentences are still close enough to juxtapose, but the common theme is much broader than feathers or food: it’s “most emu species” (“they”). The full-stop warns readers to prepare for something different, although they’ll still expect it to flow smoothly from what they’ve just read.

This next example is satisfactory:

In 1996 and 2000, he was the nominee of the Green Party; Winona LaDuke was his vice-presidential running mate.

However, the ideas are so closely connected that we might consider joining them with a comma plus and:

In 1996 and 2000, he was the nominee of the Green Party, and Winona LaDuke was his vice-presidential running mate.

You may wish to try our exercises in correcting sentences with poorly integrated ideas.

[edit] Improving your listing technique

The art of writing has been glorified through the ages. This scene was painted by a Middle-Eastern artist in 1287.
Enlarge
The art of writing has been glorified through the ages. This scene was painted by a Middle-Eastern artist in 1287.

Much encyclopedic and academic text comprises lists. The items in a list range from the very long, such as paragraphs and sections, to the very short, such as the words in a sentence (e.g., “They treat dogs, cats and parrots”). Here, we’ll focus on lists of shorter items, where the list has a discernable rhythm and contains standardised signals—punctuation and new lines—to help the reader through. Controlling the strength of the boundaries between the items is critical when constructing a list. This is achieved by manipulating the punctuation and line-formatting to achieve an optimal balance between allowing your readers to easily comprehend the list and providing them with a smooth, uninterrupted flow of words.

Lists are binary: they typically have (i) a lead, which introduces (ii) the items. (Occasionally, the order is reversed so that the listed items come first; e.g., “Limes, sugar and water are the only ingredients”.)

Here are the basic questions that you’ll need to answer when you construct a list.

  • Will it comprise a single sentence (Types 1–5 below) or multiple sentences (Types 6 and 7)?
  • Will it be a “running” list within the paragraph (Types 1–3 and 6), or a “lined” list, in which each item occupies a new, bulletted or numbered line (Types 4, 5 and 7)?
  • What kind of boundaries will you use between the items? (In other words, what combination of commas, semicolons, colons, full-stops, numbers and bullets will you use?)

First, we show you some examples of the basic types of list, followed by brief advice on formatting. Then we deal, category by category, with the commonest problems in listing.


[edit] Basic categories

We’ve prepared models and examples of main types of list—single-sentence and multisentence lists, and within these categories, running and lined lists. This is not an exhaustive list, and the guidelines here arise at least partly from personal choice. For each type, we’ve used “LEAD“ to stand for all of the words in the lead; this will run directly into a three-item list, in which the items are represented by A, B and C. Hit [Show] in the upper box to reveal the example and comments on it. Please widen your window if the display is distorted.


Single-sentence lists

Running lists

A running list is smoothly integrated into its paragraph, and will not be obvious at a glance. Occasionally, contributors to FACs are asked to change lined lists into running lists to provide greater flow and neater visual appearance. Running lists are almost ubiquitous, and we’ve all become skilled at reading them fluently—even when they’re complex. Strictly speaking, the first two sentences in this paragraph are running lists, in which the lead–item boundaries fall after “list” and “provide”, respectively. Let’s revisit these two sentences, marking the lead–item boundary with / and colouring the items.

A running list / is smoothly integrated into its paragraph, and will not be obvious at a glance. Occasionally, contributors to FACs are asked to change lined lists into running lists to provide / greater flow and neater visual appearance.

Here are some of the common types of running list.


Lined lists

Placing each item on a separate line provides even stronger boundaries, making the items visually distinct. This allows readers to digest the list easily, mentally “ticking off” each item line by line, and facilitates the re-reading and comparison of items. Lined lists allow readers to easily identify and focus on only the items that they need, which can be important in an organisation in which the same document is read by staff with very different roles and responsibilities. The white space that lined lists create can break up masses of grey paragraphs, which is more inviting to readers in many contexts. For all of these reasons, lined lists are much liked in corporate, government and administrative documents; although lined lists are less prevalent in academic (and encyclopedic) text, their use has been increasing.

Lined lists come at a cost: their very strong boundaries work against the flow of the text. This is why reviewers in the FAC room tend to object unless this formatting is used judiciously, especially at the top of an article where flow is of the essence to engage the readers. There are exceptions to this, but try to keep lined lists few in number and short, or your article will be seen as “listy” and thus more appropriate as a Featured List than a Featured Article.



Multiple-sentence lists

These are appropriate when the items are long and complex, and/or contain more than one sentence or clause. FA Criteria 2 and 3 used to be cast as single sentences, and were changed to a multi-sentence format, because the items (now Criteria 1 and 2) were thought to be easier to read as stand-alone sentences. Multi-sentence lists can be running or lined; in this subsection, we treat both types.



The model writing postcards, (1906) by Swedish painter Carl Larsson (1853–1919), famous for his idyllic watercolours
Enlarge
The model writing postcards, (1906) by Swedish painter Carl Larsson (1853–1919), famous for his idyllic watercolours

Alternative systems of numbering lists

  • Arabic numerals: (1) (2) (3)
  • Roman numerals, lower case: (i) (ii) (iii)
  • Roman letters, lower case: (a) (b) (c)—use if there are numerals within the items that may clash with the numbering system.
  • Roman letters, upper case: (A) (B) (C)—less common.
  • Any of the above, enclosed in square brackets—possible, but uncommon.
  • Any of the above without parentheses or square brackets, followed by significantly indented text.
  • English words plus comma: first(ly), second(ly), third(ly),—possible. There are variations on the spelt-out numbering system, among them:
    • First,... Second,... Third,...;
    • Firstly,... Secondly,... Thirdly,...
    • Firstly,... Second,... Third,....


Formatting

Not recommended

  • Closing parenthesis alone: 1) 2) 3)—this is not as neat as two parentheses, and slightly harder to read.
  • Number/letter plus dot and space: 1. 2. 3.—this can cause tension with sentence boundaries.
  • The bolding, italicising and other highlighting of numbers/letters—this can look messy.
  • Substantial indents for lined lists; we recommend no indent or only a small indent for the bullets or numbers—visually, lined lists are already very distinct.

[edit] Common problems

Subset terms

Subset terms frame the items of your list as part of a larger set of items. These terms need to be used with care. Common subset terms are:

  • includes and including
  • , such as (preferred to like in formal writing)
  • , particularly and , in particular
  • , especially
  • , for example, or e.g.,
  • among which are and among them ...
  • most importantly,
  • ..., etc. (avoid in encyclopedic text—it means “and the rest”, and suggests that you can't be bothered to tell us)

Many writers get into a habit of automatically using a subset term to introduce lists—especially the term “includes”. This signals to the reader that the list is incomplete—that there are other items aside from those in the list. If the list is complete (which is usually the case), use terms such as comprises or consists of instead. Here's an example.

Natural numbers include positive integers and non-negative integers.

No, that indicates that natural numbers can be other things as well; they can’t. This is correct:

Natural numbers comprise positive and non-negative integers.

or you could indicate the relationship of the items to the set and to each other more precisely:

Natural numbers are either positive or non-negative integers.

If your list is incomplete, take care not to double up on subset terms. Here, there’s one subset term before and one after the items:

The most important biographies are on Graham Greene, Patrick White and Ernest Hemingway, among others.

“The most important” indicates that you’re drawing on a larger set; telling us twice will weaken the text. This is better:

The most important biographies are on Graham Greene, Patrick White and Ernest Hemingway.


Vagueness in the lead

Rather than using a vague term, such as several or various, specify the number of items in the lead. For example, instead of:

The company’s land-mines are produced in a variety of colours—grey, dark-green, light-green and tan—for optimal camouflage.

make it:

The company’s land-mines are produced in four colours—grey, dark-green, light-green and tan—for optimal camouflage.

In any case, it’s usually unnecessary to tell us how many items we’re about to read.


The house of Noah Webster (1758–1843), the great American lexicographer, textbook author, spelling reformer and editor.
Enlarge
The house of Noah Webster (1758–1843), the great American lexicographer, textbook author, spelling reformer and editor.

Formatting errors

Check the formatting where running lists are long and/or complex, especially where you’ve removed or pasted in items. Remember the basic formulas, which hold no matter how long or complex the items:

  • A and B.
  • A, B and C.
  • A, B, C and D.
The 1973 oil crisis had significantly increased the cost of living, domestic industry was weakening from a lack of cost-competitiveness.

This is wrong (A, B); the writer has removed the C item without checking the residual formatting. Here’s the original sentence.

The 1973 oil crisis had significantly increased the cost of living, domestic industry was weakening from a lack of cost-competitiveness, and government revenues were waning.


Unnecessary repetition

Hanging hyphens

These can turn a hedgehog sentence into something more manageable. Full repetitions such as this:

Their new technology produced all of the required sounds, including two-voice, three-voice and eventually four-voice music samples.

can be reduced to:

Their new technology produced all of the required sounds, including two-, three- and eventually four-voice music samples.


Relocate clause-initial repetitions to the lead

Where every item of a single-sentence list starts the same way, relocate the repeated text up to the lead. For example:


To help strengthen the US democratic process:

  • you can lobby for the tighter regulation of political donations;
  • you can lobby for the creation of a uniform national voting process for Congressional representatives and the President; and
  • you can vote for representatives who pledge their support for the establishment of a national, independent body to determine the boundaries of congressional districts.


would be easier to read as:


To help strengthen the US democratic process, you can:

  • lobby for the tighter regulation of political donations;
  • lobby for the creation of a uniform, national voting process for Congressional representatives and the President; and
  • vote for representatives who pledge their support for the establishment of a national, independent body to determine the boundaries of congressional districts.


A medieval depiction of a monk at work in a scriptorium, showing his materials and equipment. Until the 20th century, many people devoted their lives to copying text.
Enlarge
A medieval depiction of a monk at work in a scriptorium, showing his materials and equipment. Until the 20th century, many people devoted their lives to copying text.

“And” and “or”

There’s a tendency among some writers to use “or” between the second-last and last items in a list, where they mean “and”. A, B or C means EITHER A OR B OR C. “And” is the is the default for lists in English: A, B and C. Using “and” doesn’t necessarily mean that all items in a list apply all of the time; it can still mean that only one item applies on any one occasion. For example:

Alternative terms for herbal tea that avoid the misleading word “tea” are tisane or herbal infusion.

should be:

Alternative terms for herbal tea that avoid the misleading word “tea” are tisane and herbal infusion.

English may be idiosyncratic in this respect, because we’ve noticed that many non-native speakers, particularly those who come from East Asian languages, over-prefer “or” in lists.


Category problems

Check that the semantic and conceptual boundaries between the items are distinct and logical. The most common category problem arises when one item is a subset of another. Here's an example:

He was responsible for the contents and comic strip in Megatokyo.

At first glance, the reader is justified in asking: “Isn't the comic strip part of the contents? It may be that the writer is trying to distinguish between (a) the graphics and (b) the linguistic text in the bubbles; it's hard to know.

Another problem arises when the categories are too different, usually conceptually:

The Mayans widely believed that tobacco has magical powers, and used it in divinations and talismans.

Divination is the practice of seeking knowledge of the future or the unknown by supernatural means. A talisman is an object, typically an inscribed ring or stone, that is thought to have magic powers and to bring good luck. It would have been better to treat these two uses in separate clauses or even sentences.


Consistent grammar and formatting

Keep the grammar and formatting consistent. The following list mixes two common grammatical constructions.

Preparing a FAC involves (i) copy-editing the text many times, (ii) the checking of all points of view to ensure that they are neutral, (iii) justifying the copyright of the images, and (iv) the organisation of the material into logical sections.

Two of the four items start with a "nominalisation" (the checking of and the organisation of), and two start with straight "-ing" verbs (copy-editing and justifying). Either way is fine, but you need to choose one and stick to it throughout the list. Here, we've chosen to nominalise the verb at the start of each item, which gives it a more formal, steady-state feel, rather than the active, dynamic, "doing" sense conveyed by the straight "-ing" verbs:

Preparing a FAC involves (i) the copy-editing of the text many times, (ii) the checking of all points of view to ensure that they are neutral, (iii) the justification of the copyright of the images, and (iv) the organisation of the material into logical sections.

Now your readers don't have to rejig their mental idea of the grammar to read each new item: much easier.


Here’s an example of an elaborate list from a FAC—a list of lists, in fact—that is littered with parentheses and quote marks and is illogically formatted and inconsistent. During the FAC process, this example was significantly improved; see how many areas for improvement you can identify, then hit Show to see the hints.

Hit [Show] in the top box to view hints. Hit [Show] in the bottom box to view the improved version.


THE REMAINDER OF THIS ARTICLE IS UNDER CONSTRUCTION.

[edit] Using repetition strategically

Sometimes required for cohesion; sometimes undesirable.


[edit] Saying good-bye to misplaced formality

Wikipedia needs to appeal to a wide range of native and non-native speakers, many of whom are time-poor. Writing plain English is a good way to achieve this. Many writers want to write text with an air of authority, and use longer-than-necessary and/or old-fashioned forms in the hope of appearing more formal. In most cases, you'll get your point across more effectively by avoiding the following words and phrases (suggested replacements appear after the arrows):

  • whilst --> while
  • amongst --> among
  • upon --> on
  • within --> in (unless you really need to stress "insideness")
  • in order to, in order for --> (to, or for: but note that the negative requires all words: "in order not to", or "so as not to")
  • hitherto --> until now
  • thereupon, notwithstanding (yuck)

[edit] Avoiding common grammatical weaknesses

[edit] Unclear referents

[edit] Noun plus gerund

He would not agree to the nuclear power station being built there.


He would not agree to the nuclear power station's being built there.


He would not agree to the building of the nuclear power station there.


[edit] Other technical points

The word order for “only” Megatokyo is only available in English



[edit] References

  1. ^ Souter T (2001) Eye movement and memory in the sight reading of keyboard music (doctoral dissertion, University of Sydney)—contains a review of the literature on the mechanisms of reading linguistic text and music notation
  2. ^ Miller GA (1956) The magical number seven, plus or minus two: some limits on our capacity for processing information. Psychological Review 63:81–97
  3. ^ LaBerge D and Samuels SJ (1974) Toward a theory of automatic information processing in reading. Cognitive Psychology 6:293–323
  4. ^ Ross PE (2006) The expert mind, Scientific American 295(2):46–53
  5. ^ Chase WG and Simon HA (1973) Perception in chess, Cognitive Psychology 4:5–18

[edit] External links

All of the following links are free.

[edit] For all Wikipedians

  • The Online English phrase checker. This is very useful and worth bookmarking by all serious Wikipedian editors. Enter the phrase in the search window to check any word or phrase on the Internet using the alltheweb search engine. For example, should “up-regulated” be hyphenated? Survey usage with and without the hyphen in just seconds, and make your own informed decision. Courtesy of Online English.
  • Editing exercises A set of problem sentences with click-and-show solutions, for undergraduates. MacEwan Centre, University of Calgary, Canada. Accessed 12 August 2006.
  • Ask Oxford. A free online dictionary resource, with a search box for looking up the Compact Oxford English Dictionary, information on better writing (including tips on spelling, grammar and “plain English”), a huge database of FAQs on the language, and a section on global English.
  • Better editor. This is a rich resource of style and grammar guides, dictionaries, free software downloads and other tools for serious editors.
  • The American heritage book of English Usage. We disagree with the approach on much of this site, based as it is on traditional grammar. However, we've included the address because of its search box, which enables you to access online information on your chosen topic in several popular texts. For example, you can compare what the self-appointed authorities say about the so-called split infinitive.
  • The Internet grammar of English. This is an online course in English grammar, written primarily for university undergraduates but more widely applicable. It assumes no prior knowledge of grammar. Free trial period at the moment.
  • World Wide Words. Writer and lexicographer Michael Quinion writes about interational English from a British viewpoint. Indexed articles, Q&A, reviews, topical words, turns of phrase, weird words, funnies.
  • Onelook dictionary search Enter a word (AmEng spelling) to search for dictionary websites that include that word.
  • Acronym finder. Find out what any acronym, abbreviation, or initialism stands for.
  • Mirriam Webster online dictionary and thesaurus.
  • The international system of units (SI).
  • Rowlett’s online Dictionary of units of measurement.

[edit] For second-language Wikipedians

We don’t agree with everything on these sites, but they provide valuable interactive tutorials for non-native speakers who want to improve their English. Beware a mild commercial push in a few places.

  • The English page. Free online English lessons and ESL/EFL resources.
  • Guide to grammar and writing. A huge site, full of helpful advice and interactive quizzes. For example, check out this interactive quizz on the use of “the”, “a” and nothing before nouns, a basic aspect of English grammar that is a major problem for many non-native speakers.
  • HyperGrammar. It's under construction by the Writing Centre at the University of Ottawa; the site contains errors and is incomplete, but some sections may be useful.
  • Cambridge Advanced Learner's Dictionary. An online dictionary for people learning English.
  • Your dictionary. A bit of a jungle, but perhaps worth exploring.