XionKB:Manual of style - Revision history

Alexander: /* Style rules */ new section

2023-09-06T07:02:25Z

Style rules: new section

@@ 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.
 ==Organisational features==
@@ Line 66: / Line 69: @@
 # 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.

Alexander: /* Abbreviations and jargon */ fix reference to expl template

2023-02-22T01:25:18Z

Abbreviations and jargon: fix reference to expl template

← Older revision		Revision as of 01:25, 22 February 2023
Line 46:		Line 46:

	==Abbreviations and jargon==		==Abbreviations and jargon==
	Always use the {{t\|~~abbr~~}} 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.		Always use the {{t\|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.		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.

Alexander: /* Punctuation */ new section

2023-02-22T01:23:53Z

Punctuation: new section

← Older revision		Revision as of 01:23, 22 February 2023
Line 20:		Line 20:
	: Example italicisation of book title:		: Example italicisation of book title:
	; Raw page name: '''The C Programming Language''' → displayed page name: '''''The C Programming Language'''''		; 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. <code><nowiki>__NOTOC__</nowiki></code>)
			# Template-style magic words (e.g. <code><nowiki>{{PAGENAME}}</nowiki></code>)
			# Hatnote templates (e.g. <code><nowiki>{{stub}}</nowiki></code> or <code><nowiki>{{policy}}</nowiki></code>)
			# 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, <code><nowiki>==Like so==</nowiki></code>. You should never use level one headings (e.g. <code><nowiki>=Like this=</nowiki></code>) 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 {{t\|abbr}} 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.

			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:
			* <code>&ndash;</code> → –
			* <code>&mdash;</code> → —

			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 <code>&nbsp;</code> 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.

Alexander: work on titles policy

2023-02-21T22:59:27Z

work on titles policy

← Older revision		Revision as of 22:59, 21 February 2023
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'''''

Alexander: 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..."

2023-02-20T22:35:06Z

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..."

New page

{{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 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 [[{{TALKPAGENAME}}|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 {{SITENAME}} 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.