Wikipedia:Make technical articles understandable
Wikipedia articles should be written for the widest possible general audience.
As a free encyclopedia, Wikipedia serves readers with a wide range in background, preparation, interests, and goals. Even for articles about the most technically demanding subjects, these readers include students and curious laypeople in addition to experts. While upholding the goals of accuracy, neutrality, and full coverage of the most important aspects of a topic, every effort should be made to also render articles accessible and pleasant to read for less-prepared readers. It is especially important to make the lead section understandable using plain language, and it is often helpful to begin with more common and accessible subtopics, then proceed to those requiring advanced knowledge or addressing niche specialties.
Articles should be written in encyclopedic style, but this differs from the spare and technically precise style found in scholarly monographs and peer-reviewed papers aimed at specialists. Articles should stay on topic without twisting the truth or telling "lies-to-children", but they should also be self-contained when possible, and should not take prerequisite knowledge for granted or gratuitously use unexplained jargon or advanced technical notation: shortcuts which save time and effort for experts can be barriers to the uninitiated.
Audience
Wikipedia has a varied audience who can be graded in three ways:
- On familiarity with the subject.
- The general reader has no advanced education in the topic's field, is largely unfamiliar with the topic itself, and may even be unsure what the topic is.
- The knowledgeable reader has an education in the topic's field but wants to learn about the topic itself.
- The expert reader knows the topic but wants to learn more or be reminded about some fact, or is curious about Wikipedia's coverage.
- On reading ability. Various free online tools can automatically grade the readability of text or highlight complex sentence structures, like http://www.hemingwayapp.com (automated readability index) or http://www.readabilityofwikipedia.com (Flesch reading ease).
- By motivation to learn about the topic.
A highly educated, knowledgeable, motivated reader may comfortably read a 5,000-word featured article to the end. Another reader may struggle through the lead and look at the pictures. A good article will grab the interest of all readers and allow them to learn as much about the subject as they are able and motivated to do. An article may disappoint because it is written well above the reading ability of the reader, because it wrongly assumes the reader is familiar with the subject or field, or because it covers the topic at too basic a level or is not comprehensive.
While a member of any of the audience groups may stumble upon an article and decide to read it (for example, by clicking on Special:Random), some subjects naturally attract a more limited audience. A topic that requires many years of specialist education or training prior to being studied or discussed is in general likely to have a more limited audience. For example, a topic in advanced mathematics, specialist law, or industrial engineering may contain material that only knowledgeable readers can appreciate or even understand. On the other hand, many subjects studied at an academically advanced level remain of interest to a wider audience. For example, the Sun is of interest to more than just astronomers, and Alzheimer's disease will interest more than just physicians.
Most Wikipedia articles can be written to be fully understandable by the general reader with average reading ability and motivation. Some articles are themselves technical in nature and some articles have technical sections or aspects. Many of these can still be written to be understandable to a wide audience. Some topics are intrinsically complex or require much prior knowledge gained through specialized education or training. It is unreasonable to expect a comprehensive article on such subjects to be understandable to all readers. The effort should still be made to make the article as understandable to as many as possible, with particular emphasis on the lead section. The article should be written in simple English that non-experts can understand properly.
Technical content assistance
Wikipedia strives to be a serious reference resource, and highly technical subject matter still belongs in some Wikipedia articles. Increasing the understandability of technical content is intended to be an improvement to the article for the benefit of the less knowledgeable readers, but this should be done without reducing the value to readers with more technical background.
Making articles more understandable does not necessarily mean that detailed technical content should be removed. For instance, an encyclopedia article about a chemical compound is expected to include properties of the compound, even if some of those properties are obscure to a general reader. But often summarizing highly technical details can improve the readability of the text for general readers and experts alike. For example, a long-winded mathematical proof of some result is unlikely to be read by either a general reader or an expert, but a short summary of the proof and its most important points may convey a sense to a general reader without reducing the usefulness to an expert reader. When trying to decide what amount of technical detail is appropriate to include, it may be helpful to compare with a standard reference work in the particular technical field to which the subject of the article belongs.
It is particularly important for the first section (the "lead" section, above the table of contents) to be understandable to a broad readership. Readers need to be able to tell what an article is about and whether they are reading the correct article, even if they don't already know the topic in detail. Those who are only looking for a summary or general definition may stop reading at the end of the lead. An understandable lead encourages readers to continue reading into the body of the article.
For these reasons, the lead should provide an understandable overview of the article. While the lead is intended to mention all key aspects of the topic in some way, accessibility can be improved by only summarizing the topic in the lead and placing the technical details in the body of the article. The lead of the article should tell a general reader the field of study of the topic, the place the topic holds in its field of study, what (if anything) the topic is good for, and what needs to be learned first in order to understand the article.
In general, the lead should not assume that the reader is well acquainted with the subject of the article. Terminology in the lead section should be understandable on sight to general readers whenever this can be done in a way that still adequately summarizes the article, and should not depend on a link to another article. Any link to another article should be a supplement to provide more information, and preferably should not be required for understanding text in the lead. For highly specialized topics where it is difficult to give an overview in terms with which a general audience will be familiar, it may be reasonable to assume some background knowledge in the lead while linking to the prerequisites required to understand it. For reference, the lead for a typical Featured Article includes about 20 links to other articles (with a mean lead length around 300 words).
Rules of thumb
Here are some more ideas for dealing with moderately or highly technical subjects:
Put the least obscure parts of the article up front
It's perfectly fine for later sections to be more technical, if necessary. Those who are not interested in details will simply stop reading at some point, which is why the material they are interested in needs to come first. Linked sections of the article should ideally start out at a similar technical level so that if the first, easier paragraph of an article links to a section in the middle of the article, the first part of the section linked to it should also be understandable. Further, even more-technical sections can often be improved upon by summarizing the main ideas in the first paragraph before going into details.
Avoid circular explanations: don't define A in terms of B, and B in terms of A. Check to make sure that technical terms are not used before they are defined.