Chalo Chatu:Writing better articles: Difference between revisions

From Chalo Chatu, Zambia online encyclopedia
(Created page with "This page sets out advice on how to write an effective article, including information on layout, style, and how to make an article clear, precise and relevant to the reader....")
 
Line 8: Line 8:


==== Paragraphs ====
==== Paragraphs ====
{{shortcut|WP:PARAGRAPH}}
 
Paragraphs should be short enough to be readable, but long enough to develop an idea. Overly long paragraphs should be split up, as long as the cousin paragraphs keep the idea in focus.
Paragraphs should be short enough to be readable, but long enough to develop an idea. Overly long paragraphs should be split up, as long as the cousin paragraphs keep the idea in focus.


One-sentence paragraphs are unusually emphatic, and should be used sparingly. Articles should rarely, if ever, consist solely of such paragraphs.
One-sentence paragraphs are unusually emphatic, and should be used sparingly. Articles should rarely, if ever, consist solely of such paragraphs.


Some paragraphs are really tables or lists in disguise.  
Some paragraphs are really tables or lists in disguise.


==== Headings ====
==== Headings ====

Revision as of 07:38, 8 January 2018

This page sets out advice on how to write an effective article, including information on layout, style, and how to make an article clear, precise and relevant to the reader.

Layout

Layout matters. Good articles start with introductions, continue with a clear structure, and end with standard appendices such as references and related articles.

Introductory material

Good articles start with a brief lead section introducing the topic. We discuss lead sections in greater detail below. The lead section should come above the first header; it is almost never useful to add something like ==Introduction==. Sometimes, the first section after the lead is a broad summary of the topic, and is called "Overview", although more specific section titles and structures are generally preferred.

Paragraphs

Paragraphs should be short enough to be readable, but long enough to develop an idea. Overly long paragraphs should be split up, as long as the cousin paragraphs keep the idea in focus.

One-sentence paragraphs are unusually emphatic, and should be used sparingly. Articles should rarely, if ever, consist solely of such paragraphs.

Some paragraphs are really tables or lists in disguise.

Headings

Headings help clarify articles and create a structure shown in the table of contents.

Headings are hierarchical. The article's title uses a level 1 heading, so you should start with a level 2 heading (==Heading==) and follow it with lower levels: ===Subheading===, ====Subsubheading====, and so forth. Whether extensive subtopics should be kept on one page or moved to individual pages is a matter of personal judgment. See also below under #Summary style.

Headings should not be Wikilinked. This is because headings in themselves introduce information and let the reader know what subtopics will be presented; Wikilinks should be incorporated in the text of the section.

Images

If the article can be illustrated with pictures, find an appropriate place to position these images, where they relate closely to text they illustrate. If there might be doubt, draw attention to the image in the text (illustration right).

Size

Excessively long articles should usually be avoided. Articles should ideally contain less than 50KB worth of prose. When articles grow past this amount of readable text, they can be broken up into smaller articles to improve readability and ease of editing, or may require trimming to remain concise. The headed sub-section should be retained, with a concise version of what has been removed under an italicized header, such as Main article: History of Television (a list of templates used to create these headers is available at Category:Chalo Chatu page-section templates). Otherwise, context is lost and the general treatment suffers. Each article on a subtopic should be written as a stand-alone article—that is, it should have a lead section, headings, et cetera.

When an article is long and has many sub articles, try to balance the main page. Do not put undue weight into one part of an article at the cost of other parts. In shorter articles, if one subtopic has much more text than another subtopic, that may be an indication the subtopic should have its own page, with only a summary presented on the main page.

Articles covering subtopics

Wikipedia articles tend to grow in a way that leads to the natural creation of new articles. The text of any article consists of a sequence of related but distinct subtopics. When there is enough text in a given subtopic to merit its own article, that text can be summarized in the present article and a link provided to the more detailed article. Zambia is an example of an article covering subtopics: it is divided into subsections that give an overview of the sport, with each subsection leading to one or more subtopic articles.