Xenharmonic Wiki:Conventions: Difference between revisions

(51 intermediate revisions by 10 users not shown)

Line 1:

A few conventions have evolved in this wiki that would be good to keep consistent with.

(~~please feel free~~ to ~~add rules~~ in use ~~here~~, and ~~please provide reasons for~~ it~~! Thanks!~~)

(You may add conventions to this page if you see them in widespread use on the wiki, or if you discuss them first on the talk page and there is broad consensus in favour of them.)

== Wanted pages ==

Please do not blindly create pages that appear in the [[Special:WantedPages]] list. Most of them are not actually wanted.

That list is an automatically generated list based on how many other wiki pages point to a page, but it cannot tell the difference between links written by a human, and links that occur as part of a [[:Category:Templates|functionality template]]. Most of them are "false alarms", in other words.

Here is an example of some list items on "wanted pages" that are actually legitimate, and do warrant page creation:

<small>

* Euzenius‏‎ (3 links)

* James Plamondon‏‎ (3 links)

* Joseph Ruhf‏‎ (3 links)

* LIRP-3‏‎ (3 links)

* List model‏‎ (3 links)

</small>

Here is an example of some list items that are machine-generated noise and should be ignored:

<small>

* 4L 4s (3/1-equivalent)‏‎ (5 links)

* 4L 6s (3/1-equivalent)‏‎ (5 links)

* 50th-octave temperaments‏‎ (5 links)

* 51/20‏‎ (5 links)

* 512/405‏‎ (5 links)

* 517edo‏‎ (5 links)

* 520edo‏‎ (5 links)

</small>

Of course, you can still create one of those machine-wanted pages if you actually do have something to say about it. However, we strongly advise against creating just a blank page, or a page with nothing but infoboxes, as this only creates more work for editors without adding new information for readers.

An easier and more rewarding alternative to browsing "wanted pages" is to instead check out the pages [[Xenharmonic Wiki:Things to do]] and [[Wikifuture]], which list tasks that really do need to be done.

Also check out [[:Category:Stubs]] and [[:Category:Todo:expand]]. These are short pages that need to be expanded by writing more content on them. Please help us lengthen them with more content.

== Decimal numbers ==

Use the English convention with decimal point~~, when~~ articles ~~are~~ in ~~English~~ language ~~(which is mostly the case~~).

Use the English convention with decimal point. (Exception: quotes or entire articles in another language)

{| class="wikitable"

~~! correct~~

~~! wrong~~

|-

| style="background-color: #~~efe~~" | 701.995

! Correct

| style="background-color: #~~fee~~" | <s>~~702~~,995</s>

! Avoid (example)

|-

| style="background-color: #afa;" | 701.995

| style="background-color: #faa;" | <s>701,995</s>

|}

==Logarithmic interval measures ==

== Logarithmic interval measures ==

~~For normal tables, we decided to stick to~~ [[~~cent|~~cent]] ~~values with a fixed precision, mostly 2 or 3 in~~ the ~~fractional part. 3~~ is ~~helpful when serving as a canonical reference point for people to compare their own calculations~~ with, ~~which helps in the development of table creators~~ such as [[~~Piotr Grochowski~~]]~~'s [https://scratch~~.~~mit.edu/projects/249278782/ one for Selected just intervals by error]. Its main purpose is to give an idea of interval sizes and relation to known intervals in the~~ [[~~12edo|12edo~~]] ~~system of western music. Alternative measures~~ are acceptable if they better reflect the idea behind an interval system, scale etc. ~~More than one~~ logarithmic ~~size column~~ should be avoided.

Logarithmic interval measures should generally be given in [[cent]]s since it is the most standard unit for that purpose: it is more easily understood by musicians already familiar with [[12edo]] and by many software programs, such as the [[Scala]] file format. Alternative [[interval size measure]]s are acceptable if they better reflect the idea behind an interval system, scale, etc., but "competing" columns with logarithmic sizes in the same table should usually be avoided. Simple cases like [[degree]]s alongside cents in an interval chain are acceptable.

[[Cent]] values should be written up to 3 decimal places in most contexts where precision matters, such as [[Technical data guide for regular temperaments|temperament data pages]] and other technical tables. Very small intervals may be written up to 3 significant figures, and in scientific notation if needed. In contexts where high precision does not matter as much, it is generally sufficient to round to 1 decimal place or to the nearest cent.

== Quotation marks and apostrophes ==

{{w|wp:Manual of Style#Quotation marks|As on Wikipedia}}, please:

# Use {{preferred|<big>"</big>straight quotes<big>"</big>}}, instead of {{avoid|<big>“</big>curly quotes<big>”</big>}} (the same applies for single quotes: {{preferred|<big>'</big>straight<big>'</big>}} instead of {{avoid|<big>‘</big>curly<big>’</big>}}), and straight apostrophes ({{preferred|<big>'</big>}}) instead of curly apostrophes ({{avoid|<big>’</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>`</big>accent marks<big>´</big>}} (e.g. backticks) and {{avoid|<big>′</big>prime symbols<big>′</big>}} (including, e.g. {{avoid|<big>″</big>double primes<big>″</big>}}) as quotation marks or apostrophes.

# Avoid using {{avoid|<big>&bdquo;</big>low-high quotes<big>“</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.

The templates {{tlx|'}} and {{tlx|'s}} are helpful when an apostrophe or single quote appears at the beginning or end of text in '''bold''' or ''italics'', because bold and italic text are themselves indicated by sequences of single quotes. When an apostrophe follows italicized text, {{tlx|`}} and {{tlx|`s}} can be used to additionally prevent the apostrophe from intersecting the last letter.

== Links ==

~~Links - both~~ wiki-internal and external ~~ones - should~~ have meaningful text; something like "[[Conventions|here]]" is not ~~acceptable~~, often the page title is a good starting point.

Links—both wiki-internal and external ones—should have meaningful text; something like "[[Conventions|here]]" is not very useful for understanding and orientation, often the page title is a good starting point.

: ''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)

== Original research ==

'''Original research is allowed on the Xenharmonic Wiki.''' There are a number of conventions in place to help readers distinguish between established ideas or terms and emergent ones.

Below, ''standard framework'' means the set of established ideas, and ''standard terminology'' means the set of established terms.

# By default, a page in the {{w|WP:MAINSPACE|main namespace}} should be written using the standard framework and terminology whenever possible.

#* References should be provided to support the established ideas and terms, whenever possible, and people who developed ideas and/or coined terms should be credited accordingly.

#* A page in the main namespace may contain original research if it is presented using the standard framework and terminology as much as possible; e.g. [[Generator sequence]].

#* If multiple conflicting terms coexist for a given concept, the most widespread term should be given priority; e.g. [[Superparticular ratio]] (over "epimoric ratio" or "delta-1 ratio"), but [[Delta-N ratio]] (over "superpartient ratio" and "epimeric ratio").

# A page presenting established ideas that contains a few [[:Category:Pages with idiosyncratic terms|idiosyncratic terms]] (i.e. terms used only by a single person or a small group) should have any idiosyncratic term marked as such using [[Template: Idiosyncratic]]; e.g. [[Musical cells]].

#* It is especially important to give proper credit to people who coined idiosyncratic terms, because that helps readers understand that a term is not widely used.

# A page presenting established or original ideas that uses a nonstandard framework or terminology should be placed as a [[subpage]] in the {{w|WP:USERSPACE|user namespace}}, under the editor's [[Help:User pages|user page]]; e.g. [[User:Moremajorthanmajor/8L 3s (perfect twelfth equivalent)]].

#* Alternatively, it maybe be placed as a [[Help: Editing #Subpages|subpage]] in the main namespace, under the topic's main page; e.g. [[22edo/Eliora's approach]]. This option is mainly useful for pages with more than one main contributor.

# A page presenting original ideas in a non-neutral way (e.g. an {{w|WP:Essays|essay}}, presenting its author's own argument on a given topic) should be placed as a [[subpage]] in the user namespace, under the author's user page; e.g. [[User:FloraC/There is not a third side of the river]].

#* Exceptions may be made for pages like [[:Category:Guides|guides]] written with a wide target audience, for which the main namespace offers the best visibility; e.g. [[D&D's guide]].

# A page that contains established or original ideas which are less likely to find practical applications in xenharmonic music should be marked as a [[:Category:Novelties|novelty topic]] using [[Template: Novelty]]; e.g. [[1/0]].

#* Pages about the musical application of established mathematical concepts may be marked as novelties if their relevance to xenharmonic music is too tenuous.

#* Topics which are not sufficiently related to xenharmonic music may be moved to the user namespace or deleted.

What is considered "established" may change over time and should be discussed between editors as needed. In particular, ideas built on established ideas may be considered established even if they are not as widely known as the ideas they are built on; e.g. [[SN scale]].

In addition, editors should keep in mind that other editors are more likely to edit pages in the main namespace than ones in the user namespace. In short, if you don't want other users interfering too much with your work, stay in the user namespace; and if you don't want other users interfering at all with your work, publish outside the wiki and provide a link to it on an appropriate wiki page.

== Naming articles ==

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

== Naming concepts/objects ==

We have outlined a generic rule for naming temperaments and commas. See: [[Temperament naming #Temperament and comma naming conventions]].

== See also ==

* [[~~Wiki help~~]]

* [[Help:Editing]]

* [[Help:Help|Help]]

* [[Help:Help]]

* [[Help:Migration FAQ]]

* [[Wikifuture]]

* [[Xenharmonic Wiki:Things to do]]

[[Category:~~about]]~~

[[Category:Xenharmonic Wiki guidelines]]

~~[[Category:conventions]]~~

~~[[Category:help~~]]

@@ Line 1: / Line 1: @@
 A few conventions have evolved in this wiki that would be good to keep consistent with.
-(please feel free to add rules in use here, and please provide reasons for it! Thanks!)
+(You may add conventions to this page if you see them in widespread use on the wiki, or if you discuss them first on the talk page and there is broad consensus in favour of them.)
+== Wanted pages ==
+Please do not blindly create pages that appear in the [[Special:WantedPages]] list. Most of them are not actually wanted.
+That list is an automatically generated list based on how many other wiki pages point to a page, but it cannot tell the difference between links written by a human, and links that occur as part of a [[:Category:Templates|functionality template]]. Most of them are "false alarms", in other words.
+Here is an example of some list items on "wanted pages" that are actually legitimate, and do warrant page creation:
+<small>
+* Euzenius‏‎ (3 links)
+* James Plamondon‏‎ (3 links)
+* Joseph Ruhf‏‎ (3 links)
+* LIRP-3‏‎ (3 links)
+* List model‏‎ (3 links)
+</small>
+Here is an example of some list items that are machine-generated noise and should be ignored:
+<small>
+* 4L&nbsp;4s (3/1-equivalent)‏‎ (5 links)
+* 4L&nbsp;6s (3/1-equivalent)‏‎ (5 links)
+* 50th-octave temperaments‏‎ (5 links)
+* 51/20‏‎ (5 links)
+* 512/405‏‎ (5 links)
+* 517edo‏‎ (5 links)
+* 520edo‏‎ (5 links)
+</small>
+Of course, you can still create one of those machine-wanted pages if you actually do have something to say about it. However, we strongly advise against creating just a blank page, or a page with nothing but infoboxes, as this only creates more work for editors without adding new information for readers.
+An easier and more rewarding alternative to browsing "wanted pages" is to instead check out the pages [[Xenharmonic Wiki:Things to do]] and [[Wikifuture]], which list tasks that really do need to be done.
+Also check out [[:Category:Stubs]] and [[:Category:Todo:expand]]. These are short pages that need to be expanded by writing more content on them. Please help us lengthen them with more content.
 == Decimal numbers ==
-Use the English convention with decimal point, when articles are in English language (which is mostly the case).
+Use the English convention with decimal point. (Exception: quotes or entire articles in another language)
 {| class="wikitable"
-! correct
-! wrong
 |-
-| style="background-color: #efe" | 701.995
+! Correct
-| style="background-color: #fee" | <s>702,995</s>
+! Avoid (example)
+|-
+| style="background-color: #afa;" | 701.995
+| style="background-color: #faa;" | <s>701,995</s>
 |}
-==Logarithmic interval measures ==
+== Logarithmic interval measures ==
-For normal tables, we decided to stick to [[cent|cent]] values with a fixed precision, mostly 2 or 3 in the fractional part. 3 is helpful when serving as a canonical reference point for people to compare their own calculations with, which helps in the development of table creators such as [[Piotr Grochowski]]'s [https://scratch.mit.edu/projects/249278782/ one for Selected just intervals by error]. Its main purpose is to give an idea of interval sizes and relation to known intervals in the [[12edo|12edo]] system of western music. Alternative measures are acceptable if they better reflect the idea behind an interval system, scale etc. More than one logarithmic size column should be avoided.
+Logarithmic interval measures should generally be given in [[cent]]s since it is the most standard unit for that purpose: it is more easily understood by musicians already familiar with [[12edo]] and by many software programs, such as the [[Scala]] file format. Alternative [[interval size measure]]s are acceptable if they better reflect the idea behind an interval system, scale, etc., but "competing" columns with logarithmic sizes in the same table should usually be avoided. Simple cases like [[degree]]s alongside cents in an interval chain are acceptable.
+[[Cent]] values should be written up to 3 decimal places in most contexts where precision matters, such as [[Technical data guide for regular temperaments|temperament data pages]] and other technical tables. Very small intervals may be written up to 3 significant figures, and in scientific notation if needed. In contexts where high precision does not matter as much, it is generally sufficient to round to 1 decimal place or to the nearest cent.
+== Quotation marks and apostrophes ==
+{{w|wp:Manual of Style#Quotation marks|As on Wikipedia}}, please:
+# 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>`</big>accent marks<big>´</big>}} (e.g. backticks) and {{avoid|<big>′</big>prime symbols<big>′</big>}} (including, e.g. {{avoid|<big>″</big>double primes<big>″</big>}}) as quotation marks or apostrophes.
+# 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.
+The templates {{tlx|'}} and {{tlx|'s}} are helpful when an apostrophe or single quote appears at the beginning or end of text in '''bold''' or ''italics'', because bold and italic text are themselves indicated by sequences of single quotes. When an apostrophe follows italicized text, {{tlx|`}} and {{tlx|`s}} can be used to additionally prevent the apostrophe from intersecting the last letter.
 == Links ==
-Links - both wiki-internal and external ones - should have meaningful text; something like "[[Conventions|here]]" is not acceptable, often the page title is a good starting point.
+Links—both wiki-internal and external ones—should have meaningful text; something like "[[Conventions|here]]" is not very useful for understanding and orientation, often the page title is a good starting point.
+: ''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)
+== Original research ==
+'''Original research is allowed on the Xenharmonic Wiki.''' There are a number of conventions in place to help readers distinguish between established ideas or terms and emergent ones.
+Below, ''standard framework'' means the set of established ideas, and ''standard terminology'' means the set of established terms.
+# By default, a page in the {{w|WP:MAINSPACE|main namespace}} should be written using the standard framework and terminology whenever possible.
+#* References should be provided to support the established ideas and terms, whenever possible, and people who developed ideas and/or coined terms should be credited accordingly.
+#* A page in the main namespace may contain original research if it is presented using the standard framework and terminology as much as possible; e.g. [[Generator sequence]].
+#* If multiple conflicting terms coexist for a given concept, the most widespread term should be given priority; e.g. [[Superparticular ratio]] (over "epimoric ratio" or "delta-1 ratio"), but [[Delta-N ratio]] (over "superpartient ratio" and "epimeric ratio").
+# A page presenting established ideas that contains a few [[:Category:Pages with idiosyncratic terms|idiosyncratic terms]] (i.e. terms used only by a single person or a small group) should have any idiosyncratic term marked as such using [[Template: Idiosyncratic]]; e.g. [[Musical cells]].
+#* It is especially important to give proper credit to people who coined idiosyncratic terms, because that helps readers understand that a term is not widely used.
+# A page presenting established or original ideas that uses a nonstandard framework or terminology should be placed as a [[subpage]] in the {{w|WP:USERSPACE|user namespace}}, under the editor's [[Help:User pages|user page]]; e.g. [[User:Moremajorthanmajor/8L&nbsp;3s (perfect twelfth equivalent)]].
+#* Alternatively, it maybe be placed as a [[Help: Editing #Subpages|subpage]] in the main namespace, under the topic's main page; e.g. [[22edo/Eliora's approach]]. This option is mainly useful for pages with more than one main contributor.
+# A page presenting original ideas in a non-neutral way (e.g. an {{w|WP:Essays|essay}}, presenting its author's own argument on a given topic) should be placed as a [[subpage]] in the user namespace, under the author's user page; e.g. [[User:FloraC/There is not a third side of the river]].
+#* Exceptions may be made for pages like [[:Category:Guides|guides]] written with a wide target audience, for which the main namespace offers the best visibility; e.g. [[D&D's guide]].
+# A page that contains established or original ideas which are less likely to find practical applications in xenharmonic music should be marked as a [[:Category:Novelties|novelty topic]] using [[Template: Novelty]]; e.g. [[1/0]].
+#* Pages about the musical application of established mathematical concepts may be marked as novelties if their relevance to xenharmonic music is too tenuous.
+#* Topics which are not sufficiently related to xenharmonic music may be moved to the user namespace or deleted.
+What is considered "established" may change over time and should be discussed between editors as needed. In particular, ideas built on established ideas may be considered established even if they are not as widely known as the ideas they are built on; e.g. [[SN scale]].
+In addition, editors should keep in mind that other editors are more likely to edit pages in the main namespace than ones in the user namespace. In short, if you don't want other users interfering too much with your work, stay in the user namespace; and if you don't want other users interfering at all with your work, publish outside the wiki and provide a link to it on an appropriate wiki page.
+== Naming articles ==
+{{Main|Xenharmonic Wiki: Article guidelines}}
-: ''For more info see [[Help:Here-links]]''
+== Naming concepts/objects ==
+We have outlined a generic rule for naming temperaments and commas. See: [[Temperament naming #Temperament and comma naming conventions]].
 == See also ==
-* [[Wiki help]]
+* [[Help:Editing]]
-* [[Help:Help|Help]]
+* [[Help:Help]]
+* [[Help:Migration FAQ]]
+* [[Wikifuture]]
+* [[Xenharmonic Wiki:Things to do]]
-[[Category:about]]
+[[Category:Xenharmonic Wiki guidelines]]
-[[Category:conventions]]
-[[Category:help]]