Xenharmonic Wiki:Article guidelines: Difference between revisions

@@ Line 29: / Line 29: @@
 == Use of escape templates ==
-Certain characters and character sequences have special meanings in Wiki markup, and sometimes need to be escaped using escape templates. The use of such templates should generally be done as a last resort. When displaying preformatted code, the use of escape templates is highly discouraged as doing so makes code snippets difficult to read in the source editor.
+Certain characters and character sequences have special meanings in Wiki markup, and sometimes need to be escaped using escape templates. However, when displaying preformatted code, the use of such templates is generally discouraged, and should generally be done as a last resort, since they often make code snippets difficult to read in the source editor.
-'''Incorrect source text'''
+=== Avoid (generally) ===
 <pre><nowiki>{{((}}Example Template{{))}}</nowiki></pre>
-'''Correct source text'''
+=== Preferred ===
-<pre><nowiki>{{Example template}}</nowiki></pre>
+<pre>
+&lt;nowiki&gt;{{Example template}}&lt;/nowiki&gt;
+</pre>
+or
+<pre>
+{{<nowiki />Example template}}
+</pre>
 == Use of templates for special characters ==