XionKB:Manual of style
 |
This is an official wiki policy. Its contents are considered binding for users of the WiredWiki.
| |||
Welcome to the official manual of style for the XionKB. This is our policy governing the particularities of the writing, formatting and design of articles on the wiki.
Precedent
No style manual is ever complete. While we hope to pre-emptively address as much as possible here before the wiki grows, we cannot possibly address every corner case. In the interest of consistency, we insist that editors follow the existing style in use on a given article in the absence of official guidance from this document. Codifying a consistent style for unaddressed cases into this policy should be brought up in a section on this page's talk page. Coordination and discussion about a given article's default style usage should take place on that article's talk page.
Language and dialect
The XionKB is an English wiki, therefore articles should only be written in the English language.
Furthermore, the wiki has settled on the British dialect of English. Articles written in other dialects such as American English or Canadian English should be rewritten to conform to the British spelling and grammar norms.
Organisational features
Titles
We strive to use sentence case in article titles. For example, this page is properly capitalised as XionKB:Manual of style, not XionKB:Manual of Style. In other words, avoid "book case" for titles. Furthermore, articles should be written in sentence case in prose, e.g. as "The quick brown fox jumped over the manual of style", not "The quick brown fox jumped over the Manual of Style". One major exception to this is for actual book titles, such as The C Programming Language.
Some nouns have unusual or stylised capitalisation quirks. Perhaps most relevant to our wiki are software projects, of which many have titles in all lowercase. Be sure to use the {{DISPLAYTITLE}} magic word at the top of the page to correct for this. It is also sometimes appropriate to italicise some or all of an article title; the same magic word can be used likewise to achieve this. Be sure to only use the wikicode-type italics markup of double apostrophes '', not <em/> tags, in the magic word.
- Example all-lowercase software project article
- Raw page name: Zzuf → displayed page name: zzuf
- Example italicisation of book title:
- Raw page name
- The C Programming Language → displayed page name: The C Programming Language
Article structure
Opening elements
The following items should be placed at the top of the page, in the following order as necessary:
- Underscore-style magic words (e.g.
__NOTOC__) - Template-style magic words (e.g.
{{PAGENAME}}) - Hatnote templates (e.g.
{{stub}}or{{policy}}) - Infobox template or a related image
- Opening paragraph
Opening structure
All articles should begin with an opening paragraph that introduces the subject at hand. The name of the article should appear in bold face somewhere within the first few sentences, along with any alternative names also bolded in prose.
Infoboxes should be right-aligned in parallel with the opening paragraph. Hatnotes should precede both the opening paragraph and any infoboxes.
The highest section level in use in article text is the level two heading (with two equals signs, ==Like so==. You should never use level one headings (e.g. =Like this=) in article texts; that is the style used by the article title in the wiki software itself.
Closing elements
The following items should be placed at the bottom of the page, in the following order as necessary:
- See also section
- References section
- Navigation boxes
- Mission boxes
- Category links
Abbreviations and jargon
Always use the expl template for every occurrence of an acronym or abbreviation, especially if it is technical in nature. This obviates the need for writing out the name long-hand to introduce it to the readers, making articles more concise without making them more confusing to read. It is the task of software, not editors, to mete the long form out as necessary for accessibility.
Be sure to use -s and -es as phonetically appropriate in order to pluralise any acronyms and abbreviations. Do not use apostrophes to accomplish this.
Punctuation
Dashes and hyphens
There are two forms of dashes: the en dash (–) and the em dash (—). To write these characters in page text, the following HTML entities can be used:
–→ –—→ —
Additionally, there are several rules of thumb for using dashes:
- Do not use a double hyphen (--) in place of a dash.
- Do not use a hyphen in place of a dash in an article title (e.g. Backus–Naur form, not Backus-Naur form).
- However, it is always necessary to create redirects to such articles using hyphens in place of dashes for navigability.
- En dashes are spaced, ergo they will have non-breaking spaces
on both sides of the dash. - Em dashes are unspaced, ergo the words on each side of the dash will be immediately adjacent to the dash.
- Do not use dashes to express ranges that would otherwise use the articles to or through.
- Instead of a hyphen, use an en dash when applying a prefix or suffix to a compound that itself includes a space or a dash.
- It is OK to use dashes to separate parts of an item within a list.
- Em dashes in particular should also be used to precede names in attribution of quotations.
