The Signpost

Dispatches

Common issues seen in Peer review

Don't worry: peer review is not as daunting as this!
Peer review exposes an article to a wider degree of formal scrutiny than it normally receives, and offers significant help on the journey to Good or Featured status. While each article is unique, a number of similar issues are frequently seen in articles reviewed in the Peer review process. Below we discuss these issues and provide some recommendations on how to deal with them.

Lead

While the lead is the first section our readers see, it is usually the last section in an article to be written (or at least finalized). This is because the lead should be a summary of the whole article. A good rule of thumb is to mention every section in the lead in some way, even if only through a word or phrase.

Because it is a summary, the lead should contain no material that does not appear elsewhere in the article. For the same reason, the lead should be brief — not more than four paragraphs.

While the lead can have references, most articles do not include them there (again since it is a summary, all information in the lead should be mentioned and referenced elsewhere in the article). The main exceptions to this are direct quotations and contentious claims, which should be referenced no matter where they occur.

A good way to write the lead is to wait a few days, then reread the whole article except for the lead, then try to summarize it as a lead section. Another way is to imagine that a reader is restricted to reading only the lead: what points are essential and what can be omitted in that situation?

More information

References

Citing reliable sources is critical to verifying an article's claims. A good rule of thumb is to provide at least one source for each paragraph as well as sources for all quotations, all statistics, and any claim that is challenged or likely to be challenged. Each source should clearly support the text it is used for. Blogs, personal websites, and other self-published materials are not usually reliable sources.

Wikipedia articles use what are called "inline citations", each of which is added to the main text. One option is to use parenthetical references, and another is to use clickable footnotes. For the latter, the citation details go between a pair of <ref></ref> tags. These should be placed inline directly after the end punctuation of the text that is being supported. Editors can format citations in a variety of ways, by hand or by using templates such as those of the "cite" family. A good rule of thumb for Internet sources is to include, if available, the author, title, publisher, date of publication, URL, and access date. WP:CIT includes lists of desirable data, such as ISBN numbers, for other kinds of sources.

A "References" or "Notes" section must be added to the article to make the citations fully functional. This section must contain either the <references/> tag or a small template such as {{reflist}}, which will automatically display the citation details, what is inside the <ref></ref> tags, in the "References" or "Notes" section.

Editors who use citation templates should take care not to mix the "cite" family with the "citation" family or other families. Dates in the citations of any particular article should be formatted in the same way; i.e, m-d-y or yyyy-mm-dd for US-centric articles and d-m-y or yyyy-mm-dd for most non-US-centric articles. Page ranges in the citations and elsewhere take en dashes rather than hyphens.

In addition to making Wikipedia's text verifiable, an article's citations provide readers and researchers, including other Wikipedia editors, quick access to sources that may be useful in other ways, such as when doing academic research. References add greatly to the encyclopedia's value.

More information

Images

Common image problems that are easily fixed involve size and spacing. "Thumb" is the preferred size for most images, though the lead image, maps, galleries, and panoramas are notable exceptions. It is possible to make images too small or too large, and it is possible to have too few images or too many. Judgment is required to decide how best to present an image in the larger context of the whole article. To avoid blankness on the one hand and clutter on the other, a good rule of thumb is to aim for one image per main text section and to place each image entirely within the section it illustrates. Generally, directional images such as eyes looking one way, or horses running left or right, should be placed so that "following" an image goes into the text of the page rather than away from it.

Images need captions, and it is good practice (although not explicitly required) to add alt text for readers who cannot see the images. WP:CAPTIONS has more on captions, and WP:ALT explains alt text.

Images must be properly licensed either as free-use or fair-use, and the image description and license page should include the "who, what, when, where" of the image itself, the license, the categories, and the author, original source, date, and any other information needed to verify that the license is legal and appropriate. Licensing is fairly straightforward with self-made photos but can be quite complicated in the case of images scanned from books, or obtained via Flickr, government web sites, or other sources. In these cases, great care must be taken to avoid violating copyright law.

Images used under the Fair use clause of United States copyright law must follow Wikipedia's policy on non-free content, which stipulates (in part) that fair use images must have no free equivalent, be used minimally, and must have contextual significance in the article in which they appear. So, for example, fair use images of living persons or existing buildings are almost never allowed, as they could conceivably be replaced with free images. Fair use media must be mentioned in the article in which they appear, and must add significantly to the reader's understanding of the topic.

More information

Prose

Although good prose styles can vary considerably, it is helpful to keep in mind the encyclopedia's diverse audience. A good rule of thumb is to imagine a readership of ordinary adults fluent in English but unfamiliar with the material being presented. Jargon needs to be explained or linked. Abbreviations generally need to be spelled out on first use. Slang, which can be bewildering to readers living in various places around the world, should be avoided. To the extent possible, technical material should be written in plain English and technical terms either explained or linked.

Paragraphs should be neither too long nor too short. Giant paragraphs put readers to sleep, while a succession of tiny ones clutters the page and turns prose articles into lists. Do not use lists if a passage reads easily using plain paragraphs. If an article's essence is a list, it should have a title such as "List of rivers in Asia".

Good sentence structure can vary widely, but most sentences in an article should be neither extremely long nor extremely short. Exceptions can be delicious if clear; readers do enjoy variety.

Embrace the active voice. For example, instead of "Cat was chased by Mouse," write "Mouse chased Cat". Three words beats five.

Editors are often very familiar with the subjects they write about. If the article omits useful background information, this can cause problems for general readers who are less familiar with the topic. Be sure to provide context for the reader in all articles, and to write from a real-world perspective in articles about works of fiction. WP:MOSFICT has more on writing about fiction.

More information

Manual of Style

While Wikipedia's Manual of Style (MOS) covers many topics, there are some MOS issues that are frequently seen at peer review.

Section and subsection headings should be uniquely named within an article, and should not contain links. These headings should avoid repeating the name of the article if at all possible (so in an article on Chicago, the section would not be "Chicago parks", but just "Parks"—the reader already knows the article is about Chicago). Only the first letter of the first word and proper nouns are capitalized. Avoid very short sections or subsections.

Measurements are generally given first in International System of Units (SI) units, except for articles on the US, where United States customary units may be given first, and with a partial exception for the UK. Except for some scientific articles, units should be converted so that they are given in both systems; the {{convert}} template is useful for doing this for almost any conversion.

Use a non-breaking space (&nbsp;) between numbers and units or symbols such as $3 million or State Route 43, or between dates and months to avoid awkward line breaks. The convert template does this automatically, and the {{nowrap}} template has the same effect.

Quotations should be within double quotes ("like this"). Single quotes ('like this') are used only for a quotation within a quotation: "John asked Mary 'Are you going too?', but she was not interested." Wikipedia uses logical quotation, so unless it is a complete sentence or thought, the punctuation goes outside the quotation marks. Block quotes are generally three or more lines long, and should use the {{quote}} or related templates. The {{cquote}} template is used only for pull quotes.

Do not use italics to show that something is being quoted. Italics are used for names of genera, court cases, vehicles, works of art, foreign words, and to show words as words as in "the word bumblebee ". Italics can be used for emphasis, though this is rare; bold face is never used in this way on Wikipedia.

One of the most useful features of Wikipedia is the ability to use internal links or wikilinks to direct readers to other articles in the encyclopedia. The usefulness of such links is reduced if there are too many links in the article. Only link to articles which would help increase the reader's understanding of the topic. Avoid links to common terms and generally avoid repeating the same link in an article, unless the second one is much further down and it seems important to link it.

Spell out abbreviations on first use; for example, "the Pennsylvania Department of Conservation and Natural Resources (DCNR)", rather than just "the DCNR", unless it is so well-known that this seems unnecessary ("BBC").

More information

The peer review process

There are almost always more peer review (PR) requests than reviewers, which has led to limits and restrictions. Editors are limited to one peer review request per day, and no more than four open peer reviews at one time. Peer review is for more developed articles, which must be free of any major cleanup banners, including, but not limited to {{cleanup}}, {{wikify}}, {{NPOV}}, {{unreferenced}}, or large numbers of {{fact}}, {{clarifyme}}, and {{huh}}. An article that has had a peer review, or gone through the substantial review process at FAC unsuccessfully, cannot be listed at PR until at least two weeks after the archive of its previous review, to allow time for the comments from the previous PR or FAC to be addressed.

Peer reviews that have received little or no feedback after four days are placed on the PR backlog, where they will still receive a review. As this can take time, editors who submitted articles are encouraged to look at the links in the Toolbox on the peer review page for their article, and then fix any problems found using the various tools. These toolbox links include automated tips, as well as checks for disambiguation links and external links in the article.

Be aware that peer review is a place to identify problems, but not necessarily to receive fixes for them. The reviewers at PR generally do not have time to do copyedits or other large scale fixes. Peer review is a good place to help out; even a single comment can be very useful. More reviewers are always needed and welcome!

More information

















Wikipedia:Wikipedia Signpost/2010-10-18/Dispatches