Difference between revisions of "Help:Wiki Editing Style Guide"

23 bytes removed , 10:45, 5 January 2012

sigh, how long has Wrye's stuff been here? Way to unilaterally decide our stylistic mores, Wrye. No, we don't want subpaging. Yes, we do want tutorials. Sigh. Good thing no one reads this.

Anonymous user

imported>DragoonWraith

@@ Line 72: / Line 72: @@
 ==Style Do's==
-;Subpaging
+;Use appropriate Templates in an article.
-:If you want to indicate that one article is a subpage of another article, then use a slash like so. "Big Article/Sub Article". Ordinarily this will result in a special backlink being posted on the subpage. (Oddly, it seems to be turned off the main namespace, but is working fine for User namespace -- e.g. [[User:Wrye/Demo]].)
+:The Wiki has a number of useful [[:Category:Templates|Templates]] for use in articles. In particular, the [[:Category:Article Tags|Article Tags]] can help draw the attention of editors to your page, and [[:Category:Structural Templates|Structural Templates]] like [[:Template:Function]] and [[:Template:Tools]] standardize the format of some of your information so it is easy for readers to get quickly.
 ==Style Don'ts==
 Some specific rules on style (how to write pages):
-;Don't use ':' in page titles.
+;Don't use colons in page titles.
 :Colons are used in wiki to designate namespaces (e.g. User:, Template:, etc.). While the article will generally behave correctly, it's best not to tempt fate.
 ;Don't Repeat the Page Title
 :The page title is automatically displayed at the top of the page (effectively as a level one header). Hence the title should not be repeated at the beginning of the page text.
-;Don't use First or Second Person
-:Don't be chatty. Don't talk about "I" or "you". Just present the info in straightforward, concise fashion from the third person. Does this make it hard to write tutorials? Yes. Don't write tutorials. We already have enough.
 ;Don't Submit Useless Information
-:Keep in mind that the point of the wiki is to communicate information that is ''likely to be useful'' to readers of the wiki. (Note the "likely".) I.e. don't describe some clever script that your wrote at length -- unless doing will likely be instructive to a good number of readers. If it will be useful, then trim it down to the bare bones that illustrates the information that you're trying to communicate.
+:Keep in mind that the point of the Wiki is to communicate information that is ''likely to be useful'' to readers of the wiki. (Note the "likely".) I.e. don't describe some clever script that your wrote at length -- unless doing will likely be instructive to a good number of readers. If it will be useful, then trim it down to the bare bones that illustrates the information that you're trying to communicate. Or submit it in full, in a version that can just be plugged into a mod that uses it, at [[:Category:Useful Code|Useful Code]].
 ==Conclusion==

Difference between revisions of "Help:Wiki Editing Style Guide"

Help:Wiki Editing Style Guide (edit)

Revision as of 10:45, 5 January 2012