Xenharmonic Wiki:Manual of Style: Difference between revisions

 

 

These guidelines will hopefully make life easier in this wiki, not only for authors but also for readers. Some of them are adopted from {{w|Wikipedia:Manual of Style|Wikipedia}}, but we will keep it short and trust into good communication.  

We follow {{w|WP:THE}}, {{w|WP:PLURAL}}, and {{w|WP:NCCAPS}}. In summary:  

The title or '''lemma''' should be in English sentence case (e.g. ''Sentence case'') as opposed to title case (e.g. ''Title Case''), in other words, only the first letter is capitalized if there is not an abbreviation or name in it. The reason behind this guideline is that it is much easier to remember how a lemma is spelled and it can be easily embedded into sentences without changing anything. The first letter of an in-wiki link is automatically capitalized, exactly as article names are.

The title should also be in ''singular form'' unless it is a collection for different types of things. To link to <code>[[<nowiki />interval]]</code> or <code>[[<nowiki />interval]]s</code> is much easier than to link to <code><nowiki>[[intervals|interval]]</nowiki></code>, because the link text automatically incorporates the letters following closing double brackets.

* {{Preferred|Val}} (correct)

* {{Avoid|<s>The val</s>}} (avoid)

* {{Avoid|<s>Vals</s>}} (avoid)

* {{Preferred|Normal forms}} (correct)

* {{Preferred|Online platforms}} (correct)

 

If you want to add custom visual styling, don't try to hard-code the intended style in the article namespace by adding lots of <code>{{nowrap|<<nowiki/>span style{{=}}"…">}}</code> elements. If everybody uses their own personal style, pages can easily appear messy and become hard to read and edit in the source editor. It is also hard to edit a page if you don't understand how it is constructed. If you find something that doesn't look right, try to find the responsible CSS clause for it or ask an organizer or administrator to do so. If bugs in the CSS style get fixed, this will make more than one user happy.

Within articles, use from H2 (<code><nowiki>== Title ==</nowiki></code>) for the highest level down to H6 (<code><nowiki>====== sub sub sub sub heading ======</nowiki></code>), but try to avoid too many levels of sub sections. To go down to H4 will often be enough, most articles will only use H2 levels.

 

Certain characters and character sequences have special meanings in Wiki markup, and sometimes need to be escaped using escape templates or {{w|character encodings in HTML|HTML codes}}. However, this should generally be done only as a last resort since they often make the wiki text difficult to read and edit.

Additionally, using escape templates is not necessarily effective when rendering templates with arguments, as in many cases the result may be interpreted as markup anyways. This is because escape templates merely delay the interpretation of the character sequences they represent as Wiki markup, but they assume that the character sequences themselves are ultimately to be interpreted as markup.

; Avoid (generally)

<pre<includeonly/>>

{{avoid|<nowiki>{{((}}Example template|argument{{))}}</nowiki>}}

<pre<includeonly/>>

{{preferred|<nowiki><nowiki>{{Example template|argument}}</nowiki></nowiki>}}

 

 

 

 

 

 

 

== Quotation marks and apostrophes ==

# Use {{preferred|<big>"</big>straight quotes<big>"</big>}}, instead of {{avoid|<big>&ldquo;</big>curly quotes<big>&rdquo;</big>}} (the same applies for single quotes: {{preferred|<big>'</big>straight<big>'</big>}} instead of {{avoid|<big>&lsquo;</big>curly<big>&rsquo;</big>}}), and straight apostrophes ({{preferred|<big>'</big>}}) instead of curly apostrophes ({{avoid|<big>&rsquo;</big>}}). Straight quotes and straight apostrophes are much easier to type on most keyboards than their curly (typographic) counterparts and produce fewer encoding problems.

# Avoid using {{avoid|<big>&bdquo;</big>low-high quotes<big>&ldquo;</big>}}, {{avoid|<big>「</big>corner brackets<big>」</big>}}, or {{avoid|<big>«</big>guillemets<big>»</big>}} as quotation marks, except in special cases or for non-English text that uses these marks.

 

 

== Links ==

 

: ''For more info see [[Help: Here-links]]''

 

Internal links should be as precise as possible. So, for example, if you follow a link that promises a definition of a term you don't know, it's not helpful if it brings you to an article full of new information and the expected definition hidden in a massive amount of text. (there is still a lot to be done in this area)

* [[Help: Introduction]]

* [[Help: Editing]]

[[Category:Xenharmonic Wiki guidelines]]