XionKB:Manual of style: Difference between revisions
(Created page with "{{policy}} Welcome to the official '''manual of style''' for the {{SITENAME}}. 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 art...") |
(work on titles policy) |
||
| Line 9: | Line 9: | ||
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. | 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 <code>{{ns:project}}:Manual of style</code>, not <code>{{ns:project}}:Manual of Style</code>. 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 {{meta|manual of style}}", not "The quick brown fox jumped over the {{meta|manual of style|Manual of Style}}". One major exception to this is for actual book titles, such as ''{{wp|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 <code><nowiki>{{DISPLAYTITLE}}</nowiki></code> 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 <code><nowiki>''</nowiki></code>, not <code><em/></code> 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''''' | |||
Revision as of 22:59, 21 February 2023
 |
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
