CpapWiki:Manual of Style

The Manual of Style is intended to bring some general guidelines to the way articles and pages should be formatted and structured to help make the CPAPtalk.com CPAP Wiki better. One of the nice things about a wiki is that edits do not have to be perfect since they may always be changed for correction or improvement later on. These guidelines are not "law", but will serve to make the site more uniform, and therefore easier to use. Editors should try to follow these guidelines but there are always exceptions to every rule. Above all, use common sense.

Article titles

In choosing a title for a new page or article, use the following guidelines.

• Use English.
• Use the singular.
• Avoid special characters.
• Avoid using a, an, or the as the first word.
• Avoid abbreviations.

If the wrong name is chosen for a title, the page can be moved by a Sysop, which will automatically create a redirect from the old title to the new title. Redirects should also be made from all other entries someone might type when looking for your article.

First sentence

The article should begin with a straightforward, declarative first sentence that will help the reader understand what the article contains.

As a general rule, the first (and only the first) appearance of the page title should be in the first sentence, as soon as possible, and should be bolded. Use as few links as possible before and in the bolded title.

If the subject of the page has a common abbreviation or more than one name, the abbreviation (in parenthesis) and each additional name should be bolded on its first appearance.

Sections and headers

Guidelines

Here are some guidelines for section titles and headers.

• Section names should be unique within a page. This also applies to subsections. Duplication of section names may result in a user arriving at the wrong point on the page after an edit, and may cause difficulty in understanding the page history, or linking to the proper section.

• Links should not be used in headings. Instead link the first appearance of the word in a sentence.

• Capitalize the first word only. Exceptions are proper nouns (names given to individual people, places, companies, or brands), which should be capitalized in a section name, or header.

• Section titles should not be bolded.

• Do not use special characters in headings.

• Try to keep the section title short with preferably 10 words, or less.

• Do not use the title of the whole article as a heading.

• A blank line below the heading is optional. If there are no blank lines above the heading, one line should be added, for readability in the edit window. Only two or more blank lines above or below will change the public appearance of the page by adding more white space.