User:Tony1/Build your linking skills

High-quality linking is a skill like writing. Skilled wikilinking is central to achieving good articles on Wikipedia. It is only over the past few years that we have begun to realise the potential for refining wikilinking—how sophisticated decision-making is required to achieve a high standard of linking: what to link, what not to link, how and when to research more focused links, and how to integrate links smoothly into the text. In this respect, linking deserves attention just as does the prose in our articles. Please keep in mind two things:

• your readers rely on you to guide them towards the best links;
• it is highly likely that readers click on links much less than we think they do, especially if there is dense linking.

Overlinking. Generally, there has been an increasing realisation that overlinking damages the linking system through dilution of high-value links in the vicinity, and that sprinkling low-value links through a text degrades its professional appearance and undermines readers' confidence that links will take them somewhere relevant. Thus, there is a trade-off in linking, in which increased utility needs to be balanced against the disadvantages of diluting other links in the vicinity and of crowding the text with blue. While few editors would disagree that certain items should not be linked, and certain items should be linked, there is a grey area in the middle in which the decision to link or not link is an art rather than a laid-down, universally accepted decision.

Underlinking. We believe this is less of an issue than overlinking; it is nevertheless important to provide readers with links to target articles (or article-sections) that are likely to be focused, relevant and useful. This is particularly the case in highly technical topics, and topics that naturally refer to many closely related items, such as songs in popular music articles.

Four key tests. Applying these tests may help you to make decisions about linking:

• The relevance test: Is the link-target sufficiently relevant and useful to link? (See WP:LINK.)
• The specificity test: is the link to the most focused appropriate destination? (Search for daughter articles and sections at the proposed target article.)
• The uniqueness test: is the linked topic reachable—directly or indirectly—through another link in the vicinity? (If so, consider not linking.)
• The WYSIWYG test: The "What You See Is What You Get" principle works for pipe-linking, too; when piping, avoid losing appropriate information from the actual target title—a surprisingly common error.

The exercises: unfolding design. Each exercise below will present you with a portion of text in which you can improve the linking. They are designed to be done in your head, without typing. Each one unfolds in stages that you control: first, the problem text, then a hint to help you along; then a solution; and finally an explanation. The underlying syntax is provided in coloured text where necessary. Where an item has been linked or unlinked in a solution, it is underlined to show this. The examples are taken from existing Wikipedia articles, from which reference numbers have been removed to avoid clutter.

Pace yourself. Before attempting these exercises, we recommend acquaintance with WP:LINK, the style guide that contains advice about linking, internal and external. Feedback on how to improve the exercises is welcome on the talk page. You'll get the most out of the exercises by thinking carefully about each stage before clicking on the next one. These tasks are concentrated, so expect to stop when you've had enough, and plan to return to take up where you left off. "Distributed" practice (that is, spaced over time) will have a more powerful effect than attempting all of the exercises at once ("massed" practice). Monitor your performance for fatigue.

Self-help writing tutorials:

• Exercises in weeding out fluff from article text
• Advanced editing exercises
• Spot the ambiguity
• Build your linking skills
• Using hyphens and dashes
• Copy-editing essentials, part of the Military History Academy

edit

Part I

Andy Warhol

Link to article

The problem text

In 1979, Warhol was commissioned by BMW to paint a Group 4 Race Version of the elite supercar BMW M1 for the fourth installment in the BMW Art Car Project.

Hint

There's a "chain linking" here: clicks on one (or two) of the links and you'll arrive at an article that in turn links to one of the others. Better to give the readers just one option, usually the narrower in scope.

A solution

In 1979, Warhol was commissioned by BMW to paint a Group 4 Race Version of the elite supercar BMW M1 for the fourth installment in the BMW Art Car Project.

Explanation

Click on either either BMW M1 or BMW Art Car Project and you'll immediately find a chain link to BMW. Even if the reader chooses not to follow the second link in the chain, the two specific links provide an explanation of what BMW is: a prestige German car manufacturer.

City of Manchester Stadium

Link to article

The problem text

Entry is gained by RFID smart card.

Entry is gained by [[radio-frequency identification|RFID]] smart card. (Underlying syntax)

The issue

A cryptic pipe. Piping should not require readers to hit the link to learn what the item means.

A solution

Entry is gained by radio-frequency identification (RFID) smart card.

Entry is gained by [[radio-frequency identification|radio-frequency identification (RFID)]] smart card.

Explanations

Or if there's a lot of linking in the vicinity, minimise the blue:

Entry is gained by radio-frequency identification (RFID) smart card.

Entry is gained by radio-frequency identification [[radio-frequency identification|(RFID)]] smart card.

Lisa the Vegetarian

Link to article

The problem text

The episode features several references to the Beatles and McCartney's solo career.

The episode features several references to the Beatles and McCartney's [[Paul McCartney (solo)|solo career]].

Hint

Is there an easy way to make the pipe more explicit?

A solution

• The episode features several references to the Beatles and McCartney's solo career.
• Underlying syntax: The episode features several references to the Beatles and [[Paul McCartney (solo)|McCartney's solo career]].

Comment

Now it's clear that the link goes to a page on McCartney's solo career, and not to a page on solo career in terms of the Beatles all.

Fatboy Slim

Link to article

The problem text

Cook then formed Freak Power with horn player Ashley Slater and singer Jesse Graham. They released their debut album Drive thru booty in 1994, which contained the single "Turn on, tune in, cop out". The cut was picked up by the Levi's company for use in a multimillion-dollar advertising campaign. In 1996, Cook re-joined Freak Power for the second album More of everything for everybody.

Hint

This is a mixed bag: there's serious underlinking and there's irritating overlinking. You may have to type a few items into the search box to determine whether there's an article on them.

A solution

Cook then formed Freak Power with horn player Ashley Slater and singer Jesse Graham. They released their debut album Drive thru booty in 1994, which contained the single "Turn on, tune in, cop out". The cut was picked up by the Levi's company for use in a multimillion-dollar advertising campaign. In 1996, Cook re-joined Freak Power for the second album More of everything for everybody.

Explanation

So you searched for and found articles on "Freak Power", "Ashley Slater", and the song "Turn on, tune in, cop out" (great title!). These need to be linked.

Underlinking. And you searched for and did not find articles on "Jesse Graham", "Drive thru booty", and "More of everything for everybody". You can go ahead and link these items to create "red links" for them; this may encourage an editor to subsequently create real articles on those topics, but has the disadvantage of looking cruddy in the text. Certainly to be avoided near the top, or go create a stub to turn red to blue.

Overlinking. The link for "advertising" needs to be shot down on sight: your readers are expected to speak English, and the term is not technically important or that target article helpful for understanding this topic of Fatboy Slim. Shift the blue to guide your readers towards the valuable targets.

More elegant option? Just one thing I noticed by going to Levi's: the real name of the article to which this redirects is Levi Strauss & Co. so you might consider whether this is more elegant than "the Levi's company". Up to you.

Link tip. Red links can turn blue (when an article is started); blue links can turn red (when a target article is deleted); the wording of target section-titles can be changed without editors' realising the effect this may have on links that are anchored to it. Link maintenance is an important part of keeping our article standards high.

Among the most valuable editorial work performed by WPians is referred to as "gnoming"—useful incremental edits behind the scenes, tying up loose ends and making articles read more smoothly. We would be delighted if more people considered doing a little link-gnoming. It can be very satisfying to choose a category of articles you like and to work through them systematically. Gnoming can involve (1) clicking on some or most of the links to check that they're optimal; (2) looking out for over- and underlinking; and (3) applying the WYSIWYG test to pipes.

Part II

Greengage

Link to article

The problem text

Soon after, Greengages were cultivated in the American colonies, and were even grown on the plantations of American presidents George Washington (1732–99) and Thomas Jefferson (1743–1826). However, the cultivation of greengages in North America has declined significantly since the 18th century.

Soon after, Greengages were cultivated in the [[Colonial America|American colonies]], and were even grown on the plantations of [[President of the United States|American presidents]] [[George Washington]] (1732–99) and [[Thomas Jefferson]] (1743–1826). However, the [[cultivation]] of greengages in [[North America]] has declined significantly since the [[eighteenth century|18th century]].

The issues

Overlinking: check the relevance, focus and utility of each link, the guideline on chronological items, and one or two rules at WP:LINK about the locating of links in the text.

Partial hint

Apart from overlinking, there's the "don't jam links together" rule and the "link the first occurrence" rule.

A solution

Probably none of the links is justified. Was that your conclusion?

• Soon after, Greengages were cultivated in the American colonies, and were even grown on the plantations of American presidents George Washington (1732–99) and Thomas Jefferson (1743–1826). However, the cultivation of greengages in North America has declined significantly since the 18th century.

Explanations

• "Cultivated/ation" is a common word, and should not be linked. If it were going to be linked, the first rather than the second occurrence would be correct.
• Relevance test: The articles "American presidents", "Washington" and "Jefferson" are almost certainly irrelevant to this vegetable. If there's a section in either article about one of the president's passion for gardening, and it adds to readers' understanding, perhaps a section-link might be appropriate. However, a link in the other direction might be more appropriate (Greengage within the "Jefferson" article).
• "Adjacency: American presidents" and "George Washington" are jammed up against each other.
• Well-known geographical term: "North America" is a well-known geographical entity, and WP:LINK says they should not normally be linked. "American colonies" (piped from "Colonial America") is a well-known entity; perhaps there is a more focused section there on domestic agriculture, although it's unlikely.
• Chronological item: "18th century" is a chronological item—a huge one at that—and should not normally be linked.

Donnchadh, Earl of Carrick

Link to article

The problem text

As a result of his father's conflict with Uhtred and the Scottish king William the Lion, Donnchadh became a hostage of King Henry II of England.

As a result of his father's conflict with Uhtred and the Scottish king [[William I of Scotland|William the Lion]], Donnchadh became a hostage of King [[Henry II of England]].

Hint

There's something awkward about one of these links; read the sentence aloud and think of the titles.

A solution

As a result of his father's conflict with Uhtred and the Scottish king William the Lion, Donnchadh became a hostage of King Henry II of England.

As a result of his father's conflict with Uhtred and the Scottish king [[William I of Scotland|William the Lion]], Donnchadh became a hostage of [[Henry II of England|King Henry II of England]].

Explanation

The generic "king", with a small k, is not part of the first compound title that is linked (as though, "the Scottish king, William the Lion"); but "King", with upper-case K, is part of the title "King Henry II of England": it is awkward to see part of the title black and part of it blue.

Voting age

Link to article

The problem text

A voting age is a minimum age established by law that a person must attain to be eligible to vote in a public election. The vast majority of countries in the world have established a voting age, with the implication that those of an age lower than the chosen threshold lack the necessary capacity to independently decide how to cast a vote. The voting age is sometimes considered to be of such importance that it is set by constitutional provision.

The issue

Overlinking. Ask yourself how relevant each link is to increasing the understanding of this topic by most readers. Editors may differ as to the final solution.

A solution

A voting age is a minimum age established by law that a person must attain to be eligible to vote in a public election. The vast majority of countries in the world have established a voting age, with the implication that those of an age lower than the chosen threshold lack the necessary capacity to independently decide how to cast a vote. The voting age is often of such importance that it is set by constitutional provision.

Explanations

• The relevance test: The first four of the five linked items should probably not be linked ("law", "vote", "public" and "election"). If there is doubt, check the destination articles, which are far too general to assist all but readers who need an English dictionary at their side. "Public" was the stand-out useless link. We allowed the fifth link, to "Constitution", because it is more technical and less likely to be commonly understood as a concept (i.e., statute versus constitution). Some editors may not have linked it.
• Adjacent links: "public election" ("[[public]] [[election]]"). Aside from the question of their relevance, the reader should not have to hover their cursor over this patch of blue to learn whether it is one or two links. WP:LINK says: "When possible, avoid placing links next to each other so that multiple links look like a single one,... Consider rephrasing the sentence, omitting one of the links, or using a more specific single link." However, we concede that sometimes it's very hard to avoid adjacency.
• Suffix: Note the use of adjectival syntax in [[constitution]]al; you can always see this displayed in the edit mode. Such abbreviated syntax is easier to write and edit than the full piped version ([[constitution|constitutional]]), and is preferred to piping.

World War I

Link to article

The problem text

More than 15 million people were killed, making it one of the deadliest conflicts in history.

More than [[World War I casualties|15 million people]] were killed, making it one of the [[list of wars and disasters by death toll|deadliest conflicts]] in [[history]].

The issues

(1) Unusual, "cryptic" pipe; (2) overlinking.

Hint

"15 million people"—is there a slightly better part of the sentence you could use as the pipe to World War I casualties?

A solution

More than 15 million people were killed, making it one of the deadliest conflicts in history.

More than 15 million people [[World War I casualties|were killed]], making it one of the [[list of wars and disasters by death toll|deadliest conflicts]] in history.</nowiki>

Link tip: The two world wars that occurred during that brutal and chaotic century, the 20th, are so well-known that it is usually not necessary to link them. The exception may be in Military History articles.

Part III—let's look at popular entertainers

John Denver

Link to article

The problem text

Denver became outspoken in politics in the mid-1970s. In 1976, he campaigned for the election of Jimmy Carter, who became a close friend and ally. Denver was a supporter of the Democratic Party, and a number of charitable causes for the environment, the homeless, the poor, the hungry, and the African AIDS crisis. He founded the charitable Windstar Foundation in 1976 to promote sustainable living. His dismay at the Chernobyl disaster led to precedent-setting concerts in parts of communist Asia and Europe.

Denver became outspoken in politics in the mid-1970s. In 1976, he campaigned for the election of Jimmy Carter, who became a close friend and ally. Denver was a supporter of the [[Democratic Party (United States)|Democratic Party]], and a number of [[Charitable cause|charitable]] causes for the [[Environmentalism|environment]], the [[homelessness|homeless]], the [[poverty|poor]], the hungry, and the [[HIV/AIDS in Africa|African AIDS crisis]]. He founded the charitable [[Windstar Foundation]] in 1976 to promote [[sustainable living]]. His dismay at the [[Chernobyl disaster]] led to precedent-setting concerts in parts of [[communism|communist]] [[Asia]] and [[Europe]].

The issues

(1) The linking of common words; (2) a misleading pipe-link; (3) underlinking.

A solution

Denver became outspoken in politics in the mid-1970s. In 1976, he campaigned for the election of Jimmy Carter, who became a close friend and ally. Denver was a supporter of the Democratic Party, and a number of charitable causes for the environment, the homeless, the poor, the hungry, and the African AIDS crisis. He founded the charitable Windstar Foundation in 1976 to promote sustainable living. His dismay at the Chernobyl disaster led to precedent-setting concerts in parts of communist Asia and Europe.

Denver became outspoken in politics in the mid-1970s. In 1976, he campaigned for the election of [[Jimmy Carter]], who became a close friend and ally. Denver was a supporter of the [[Democratic Party (United States)|Democratic Party]], and a number of charitable causes for the environment, the homeless, the poor, the hungry, and the [[HIV/AIDS in Africa|African AIDS crisis]]. He founded the charitable [[Windstar Foundation]] in 1976 to promote [[sustainable living]]. His dismay at the [[Chernobyl disaster]] led to precedent-setting concerts in parts of communist Asia and Europe.

Explanation

• "Jimmy Carter", the 1976 presidential candidate, probably needs to be linked, the more so because some readers will not be aware of his prominent role in US public life at the time.
• Trivial dictionary-type links that drown out the important ones are "charitable", "environment", "homeless", "poor", probably "communist", and certainly the common geographical terms "Asia" and "Europe".
• The other items seem well-judged as links.

Janis Joplin

Link to article

The problem text

During this period, she used other intoxicants and was a heavy drinker throughout her career; her trademark beverage was Southern Comfort.

During this period, she used other [[psychoactive drug|intoxicants]] and was a [[alcoholism|heavy drinker]] throughout her career; her trademark beverage was [[Southern Comfort]].

The issues

(1) Presumptuous piping (a serious matter of accuracy); (2) possibly common-enough terms not to require linking.

Hint

Is any information lost or introduced by the pipes? If so, this should be thought about carefully.

A solution

During this period, she used other psychoactive drugs and was a heavy drinker throughout her career; her trademark beverage was Southern Comfort.

Explanations

"Intoxicants" could be anything from magic mushrooms to cocaine; "psychoactive drugs", the link target, is more specific and should be explicit in the text. It is hardly an obscure term, so probably doesn't need linking here.

Heavy drinking is not necessarily alcoholism; Wikipedia could conceivable be sued for libel for the confusion in this pipe. Do be careful: check the sources, and if she was an alcoholic through her heavy drinking, explain it, probably without linking.

Since it is clear from the text that "Southern Comfort" is a brand of liquor, the link is of questionable value.

Bessie Smith

Link to article

The problem text

Smith's career was cut short by a combination of the Great Depression and the advent of "talkies", which spelled the end for vaudeville. While the days of elaborate vaudeville shows were over, Smith continued touring and occasionally singing in clubs. In 1929, she appeared in a Broadway flop called Pansy, a musical in which, the top critics agreed, she was the only asset.

The issues

(1) Again, the close relationship between the prose and the linking is at issue (the word for one link needs to be changed); (2) underlinking; and (3) probably one case of overlinking.

A solution

Smith's career was cut short by a combination of the Great Depression and the advent of sound films, which spelled the end for vaudeville. While the days of elaborate vaudeville shows were over, Smith continued touring and occasionally singing in clubs. In 1929, she appeared in a Broadway flop called Pansy, a musical in which, the top critics agreed, she was the only asset.

Explanations

Clearer linking word. "Talkies" is possibly a little informal for this context, and many readers will need to hit the link to find out what it means, which is undesirable. In any case, Talkies redirects to "Sound film", which is a much easier term for readers to understand: it should be used instead, and you can drop the quotation marks, since it's an obvious reference.

Underlinking. We chose to link Great Depression, although some editors may prefer not to, particularly in a densely linked passage. "Vaudeville" is a specific genre that is probably worth linking, unlike the well-known term "musical" (straight after the link to "Broadway theatre").

Whoopi Goldberg

Link to article

The problem text

Goldberg performed the role of Califia, the radiant Queen of California, for a theater presentation called Golden Dreams at Disney's California Adventure, the second gate at the Disneyland Resort, in 2000. The show, which explains the history of the Golden State (California), opened on February 8, 2001.

Goldberg performed the role of [[Califia]], the radiant Queen of [[Island of California|California]], for a theater presentation called ''[[Golden Dreams]]'' at [[Disney's California Adventure]], the second gate at the [[Disneyland Resort]], in 2000. The show, which explains the history of the [[Golden State]] ([[California]]), opened on February 8, 2001.

The issues

What a mess. There are three issues: (1) one pair of links is "chained", and therefore only one of the pair needs to be linked; (2) there is one case of deceptive piping; (3) one link goes to a disambiguation page, which is bad practice.

A solution

Goldberg performed the role of Califia, the radiant Queen of the mythical Island of California, for a theater presentation called Golden Dreams at Disney's California Adventure, the second gate at the Disneyland Resort, in 2000. The show, which explains the history of California, "the Golden State", opened on February 8, 2001.

Goldberg performed the role of [[Califia]], the radiant Queen of the mythical [[Island of California]], for a theater presentation called ''[[Golden Dreams]]'' at [[Disney's California Adventure]], the second gate at the Disneyland Resort, in 2000. The show, which explains the history of California, "the Golden State", opened on February 8, 2001.

Explanations

Chained links. Disney's California Adventure, needless to say, links to its location, "Disneyland Resort" in its first sentence. One link is quite sufficient if a reader wants to divert to these articles.

Deceptive piping. [[Island of California]] was reduced to a quite misleading pipe, [[Island of California|California]]. By visiting the article, you'll see that it needs to be explained in the text here.

Bad redirect. The Golden State goes to a whole group of articles, and the reader will have a hard time working out the intended one. In fact, there's no article specifically for this nickname of California, and the state is so well-known it is hardly worth the dilution. Don't link;instead, clarify the meaning in the text.

Conclusion. The sentence looks visually tidier, the important links stand out more, and the confusion introduced by the links has been clarified.

Link tip. OK, here's the deal with popular culture articles: they typically need to link to the many items that refer to musical output (songs, tracks, albums), other musicians, and bands. It is therefore of great importance that common terms not be linked unless absolutely necessary, to avoid diluting these many valuable links. Unfortunately, articles on popular culture tend to indulge in the significant overlinking of trivial terms (I've seen "roses", "suicide", "divorce" and "high school" recently, which detracted from the useful links).

In popular culture articles, generally don't link these items:

• American/US/U.S.; British, English/UK; Canadian; Irish; Australian
• New York (City); Los Angeles; London
• actor/actress; comedian;singer(-songwriter); writer/author
• film/cinema; television; radio; CD; DVD; documentary; theater
• née (woman's surname before marriage); autobiography; divorce; libel; cancer;
• game show; talk show; host
• dates, decades, centuries