Difference between revisions of "Help:Contributors Handbook"

From The Orthorbbae Library
Jump to: navigation, search
Line 3: Line 3:
 
[[Category:Contributors Handbook]]
 
[[Category:Contributors Handbook]]
  
This page sums up the guidelines that a contributor should be familiar with before diving into major page edits.
+
Hi there, new recruit! Welcome to the Official Drowtales Wiki. :)
 +
 
 +
Before diving into editing, there’s a few things that we’d like all contributors to keep in mind before making any major edits.
  
 
* For help with templates, see [[Help:Templates]].
 
* For help with templates, see [[Help:Templates]].
Line 11: Line 13:
  
 
These are the basic rules governing WHAT you should write.
 
These are the basic rules governing WHAT you should write.
* '''Avoid bias.''' You should remain as neutral as possible.
 
* '''Avoid speculation.''' Every statement should be backed by a canon source material. Statements that are prone to be questioned should be backed up explicitely by specifying the source material using the <ref> tag. See [[Help:Citing sources]] for more details on the <ref> tag usage.
 
  
== Style ==
+
'''1. Canon is key''' -  The golden rule for content! This is the official wiki, so all content in the main namespace  must be taken from canon sources.
 +
 
 +
 
 +
: '''''Sources that ARE considered canon include:'''''
 +
* Moonless Age comic
 +
* Official side stories listed here
 +
* Official concept art produced by Kern
 +
 
 +
: '''''Sources that are NOT considered canon include:'''''
 +
* Relic Hunters, Daydream, Path to Power, and Mel’s Knighthood
 +
* Forum posts
 +
* Podcasts
 +
* Cameo character descriptions that are not shown in the MA comic or official concept art
 +
* “But Kern said it once”
 +
 
 +
 
 +
: As a general rule, if you can’t supply a link to a page or news post that supports your facts, then they are not allowed on the wiki. (See:  Citing Sources)
 +
 
 +
: ''Note: Pages in the RH and DD namespaces have their own rules. See [[Help:Relic Hunters Guide]] and [[Help:Daydream Guide]]''
  
These are the basic rules governing HOW you should write.
 
* '''Start the article with an introduction.''' Every article should start with a short paragraph that sums up the topic of the page. This is the bare minimum that justifies the page existence. Articles that contain nothing but introduction are called ''Stubs''
 
* '''Use headings.''' In order to be readable, the article should have a clear logical structure.
 
* '''Avoid giant walls of text.''' Quality beats quantity.
 
  
== Form ==
+
'''2. Avoid bias and speculation''' - Try to remain as neutral as possible. We all have our theories, but please keep them off the official pages. Unless something is explicitly shown, it is not to be posted on the wiki.
  
Writing a wiki entry is different than writing an article on the paper. Wiki engine offers many features that help the reader navigate the wiki or help the contributors maintain it and keep it up to date. In order for these to work as designed, the contributor must be familiar with the following techniques:
+
Tips:
 +
* Don’t jump to conclusions – Heavy implications are not facts!
 +
* Encourage edits to pages you write – We all have favorites we can’t shake – the more people editing an article the better it will be!
 +
* If you’d like to discuss your theories, please visit the Moonless Age forums.
  
* '''Use keyword links.''' If you use any term that does or may in the future have a dedicated page (especially things like character/clan/location names), turn it into a link. [http://www.mediawiki.org/wiki/Links#Internal_links How to create internal links]
 
* '''Use redirects.''' If a character/clan/whatever is known by a multiple names, create a redirect page for all the common variants. This makes the keyword links work better, makes the search function work better and minimizes the danger of two independent pages being created for a single topic. [http://www.mediawiki.org/wiki/Help:Redirects How to create a redirect]
 
* '''Designate a "featured" section.''' If you enclose any 3-5 sentences in the article between the <section begin=feature/> <section end=feature/> tags, they become the article summary. This summary can then be automatically processed by various overview pages. Example of which are the lists of characters on clan pages.
 
* '''Start every page with a page type marker.''' For example if the page is about clan, it must start with a {{tl|Clan}} template. [http://www.mediawiki.org/wiki/Template What is a template]
 
* '''End every page with a "last update" note.''' Use the {{tl|last update}} template for this.
 
  
See [[Help:Templates]] for more information on various templates that are at your disposal.
+
== Style ==
  
== Standard layouts ==
+
These are the basic rules governing HOW you should write.
  
Some common types of pages have a standard structure that should be respected.  
+
'''1. Use proper spelling and grammar''' – Someone will probably fix it if you don’t, but please don’t depend on it.
  
=== Clan Page ===
+
'''2. Use headings''' – Use headings to break up your walls of text. It will make it easier for readers to navigate your article. This is especially important for biographies or event timelines.
  
A clan page consist of the following parts (in the given order):
+
'''3. Quality beats quantity''' – the more brief you can be, the better!
* The {{tl|Clan}} template
 
* An introductory paragraph (with no header, so that it gets placed before the table of contents). Enclose 3-5 helpful sentences between the <section begin=feature/> <section end=feature/> tags. This will be the text that can be used as this Clan's summary on overview pages.
 
* The main content. Customary section headings are ''History'' and ''Culture and Politics''. More sections can be used when deemed appropriate.
 
* The ''Clan Members'' section, usually with three subsections: ''Ill'hares'', ''Important Members'' and ''Other members''. More subsections may be used when deemed appropriate. The characters are listed using the {{tl|CharacterList}} template.
 
* The {{tl|Last update}} template.
 
  
For an example of a correctly formatted Clan page, see [[Val'Sullisin'rune|here]].
+
== Form ==
  
=== Character Page ===
+
Writing a wiki entry is different than writing an article on the paper. Wiki engine offers many features that help the reader navigate the wiki or help the contributors maintain it and keep it up to date. In order for these to work as designed, the contributor must be familiar with the following techniques:
  
: See [[Help:Character Page]]
+
'''1. Use the page guides''' – Most page types have a blank guide that you can copy and paste. Just fill in the blanks with the appropriate information. When editing existing pages, follow existing guidelines to keep the wiki organized.
  
=== Location Page ===
+
* Page guides can be found here: [[Help:Page Guides]]
  
: See [[Help:Location Page]]
+
'''3. Check out the Formatting Guide''' for tips on using pictures, headings, lists and other features.
  
=== Event Page ===
+
'''4. When all else fails''' - search the [http://www.mediawiki.org/wiki/MediaWiki MediaWiki wiki] or e-mail [[User:Jak'iaah|Jak’iaah]]. :)
  
: See [[Help:Event Page]]
+
See [[Help:Templates]] for more information on various templates that are at your disposal.

Revision as of 14:22, 15 August 2013

Farm-Fresh construction.png
Work in progress
This area is currently under construction. Heavy changes are to be expected.

Hi there, new recruit! Welcome to the Official Drowtales Wiki. :)

Before diving into editing, there’s a few things that we’d like all contributors to keep in mind before making any major edits.

Content

These are the basic rules governing WHAT you should write.

1. Canon is key - The golden rule for content! This is the official wiki, so all content in the main namespace must be taken from canon sources.


Sources that ARE considered canon include:
  • Moonless Age comic
  • Official side stories listed here
  • Official concept art produced by Kern
Sources that are NOT considered canon include:
  • Relic Hunters, Daydream, Path to Power, and Mel’s Knighthood
  • Forum posts
  • Podcasts
  • Cameo character descriptions that are not shown in the MA comic or official concept art
  • “But Kern said it once”


As a general rule, if you can’t supply a link to a page or news post that supports your facts, then they are not allowed on the wiki. (See: Citing Sources)
Note: Pages in the RH and DD namespaces have their own rules. See Help:Relic Hunters Guide and Help:Daydream Guide


2. Avoid bias and speculation - Try to remain as neutral as possible. We all have our theories, but please keep them off the official pages. Unless something is explicitly shown, it is not to be posted on the wiki.

Tips:

  • Don’t jump to conclusions – Heavy implications are not facts!
  • Encourage edits to pages you write – We all have favorites we can’t shake – the more people editing an article the better it will be!
  • If you’d like to discuss your theories, please visit the Moonless Age forums.


Style

These are the basic rules governing HOW you should write.

1. Use proper spelling and grammar – Someone will probably fix it if you don’t, but please don’t depend on it.

2. Use headings – Use headings to break up your walls of text. It will make it easier for readers to navigate your article. This is especially important for biographies or event timelines.

3. Quality beats quantity – the more brief you can be, the better!

Form

Writing a wiki entry is different than writing an article on the paper. Wiki engine offers many features that help the reader navigate the wiki or help the contributors maintain it and keep it up to date. In order for these to work as designed, the contributor must be familiar with the following techniques:

1. Use the page guides – Most page types have a blank guide that you can copy and paste. Just fill in the blanks with the appropriate information. When editing existing pages, follow existing guidelines to keep the wiki organized.

3. Check out the Formatting Guide for tips on using pictures, headings, lists and other features.

4. When all else fails - search the MediaWiki wiki or e-mail Jak’iaah. :)

See Help:Templates for more information on various templates that are at your disposal.