Pages

From IMSMA Wiki
Revision as of 12:27, 9 September 2013 by Daniel (talk | contribs) (Added to intro)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Pages on the IMSMA Wiki are structured into several headings. The page title is the top Level 1 heading displayed above each page's contents. The title indicates what the page is about and is a unique reference to the page. The title may simply be the name of the subject of the page, or it may be a description of the topic. This page explains the considerations, or naming conventions, on which choices of page title are based. When possible, the page should start with the name of the page in bold. Avoid starting the page with a heading.

Deciding on a page title

A good IMSMA page title has the five following characteristics:

  • Recognizability: the title is a name or description of the subject that someone familiar with, although not necessarily an expert in, the subject will recognize.
  • Naturalness: the title is one that IMSMA users are likely to look or search for and that editors would naturally use to link to the page from other pages.
  • Precision: the title is sufficiently identify the page's subject and distinguish it from other subjects.
  • Conciseness: the title is no longer than necessary to identify the page's subject and distinguish it from other subjects.
  • Consistency: the title is consistent with the pattern of similar pages' titles.

Format

The following points are used in deciding on questions not covered by the five principles. Consistency on these helps avoid duplicate articles:

  • Short: Keep titles short but descriptive.
  • Unique: No two page titles should have the same title.
  • Capitalisation: The first letter of every word should be capital, except for prepositions and articles. Titles cannot begin with a lowercase letter.
  • Singular: In general only create page titles that are in the singular, unless that term is always in a plural form in English or it is valid to use in an IMSMA context like Sub-Themes, Customise Views, localisation files, etc.
  • Acronyms: Should be used in a page name if the subject is known primarily by its abbreviation and that abbreviation is primarily associated with the subject, otherwise avoid using Acronyms. All acronyms will be in the glossary.
  • Symbols: Titles cannot contain certain restricted characters (e.g # < > [ ] | { } : ) or encoded characters (%, &#47).
    • Titles cannot contain 3 or more contiguous tildes (~~~), as strings of tildes are used to create editors' signatures on talk pages.
    • Titles should not include question marks.
  • Spaces: MediaWiki treats Spaces ( ) and underscores (_) are equivalently. Underscores are used in URL and Spaces in displayed titles, there is no need to add underscore in the page titles.
  • Formatting: It is not possible for a title as stored in the database to contain formatting, such as italics or bolding. The double or triple apostrophes normally used to produce these effects in wikitext are treated just as groups of apostrophes if they appear in titles but avoid apostrophes and quotes unless absolutely required.
  • Images: Titles cannot contain images.

Section headings

Equal signs are used to mark the enclosed text as a section heading: ==Title== for a primary section; ===Title=== for the next level (a subsection); and so on to the lowest-level subsection, with =====Title=====. (The highest heading level technically possible is =Title=; but do not use it in pages, because it is reserved for the automatically generated top-level heading at the top of the page containing the title of the whole page.) The heading must be typed on a separate line. Include one blank line above the heading, and optionally one blank line below it, for readability in the edit window.

Readability

An article longer than one or two pages when printed should be divided into sections to ease navigation. Articles that cover particularly technical subjects should, in general, be shorter than articles on less technical subjects.

Talk pages

Talk pages are used to discuss the development of their corresponding Page. The discussions are hence not intended to be generic on the topic of the Page, but centred on edits and structure of the page.

User talk pages

While the purpose of talk pages is to discuss the content of pages, the purpose of user talk pages is to draw the attention or discuss the edits of a user. IMSMA Wiki is not a social networking site, and all discussion should ultimately be directed solely toward the improvement of the wiki. As opposed to the case with the Main name space, users may freely remove comments from their own talk pages.