Categorizing guideline: Difference between revisions

From The DarkMod Wiki
Jump to navigationJump to search
(first draft describing current scheme)
 
(add coding, SDK and DarkRadiant cats to tree)
 
(2 intermediate revisions by the same user not shown)
Line 17: Line 17:
== Tagging ==
== Tagging ==


Tutorial articles are tagged with templates that start with <code><nowiki>{{tutorial-</nowiki></code>.
Tutorial articles are tagged with templates that start with <code><nowiki>{{tutorial-</nowiki></code>, like <code><nowiki>{{tutorial-water}}</nowiki></code>.


Everything that doesn't really fit to be a tutorial is tagged with a template that just consists of the topic of the article, like <code><nowiki>{{textures}}</nowiki></code> or <code><nowiki>{{water}}</nowiki></code>.
Everything that doesn't really fit to be a tutorial is tagged with a template that just consists of the topic of the article, like <code><nowiki>{{textures}}</nowiki></code> or <code><nowiki>{{water}}</nowiki></code>.


See [[Assigning your Page to a Category]] for how to do add the correct template.
While you can add more than one  template, you '''must''' use only '''one kind''' of template to tag articles! See [[Assigning your Page to a Category]] for how to do add the correct template.


== Category-Tree ==
== Category-Tree ==
Line 35: Line 35:
       ... and so on
       ... and so on
   Editing
   Editing
    Coding
      SDK
      DarkRadiant
      ... and so on
     Textures
     Textures
       Texture Tutorials
       Texture Tutorials
Line 41: Line 45:
     Water Tutorials
     Water Tutorials
     .. and so on
     .. and so on
  General
   Universe
   Universe
   .. and so on
   .. and so on


# Each category contains all the articles from the sub-categories, too (except the Documentation category).
# Each category contains '''all''' the articles from the sub-categories, too (except the Documentation category).
# Each editing subcategory also contains the appropriate tutorial category.
# Each editing subcategory also contains the appropriate tutorial category.
# The [:Category:Tutorial|Tutorial category] contains '''only''' tutorial articles.
# The [[:Category:Tutorial|Tutorial category]] contains '''only''' tutorial articles.
# The [:Category:Editing|Editing category] contains '''all''' editing articles, including tutorials.
# The [[:Category:Editing|Editing category]] contains '''all''' editing articles, including tutorials.


This means the [[:Category:Editing|Editing]] category contains all the articles from the ''Water'' category,
This means the [[:Category:Editing|Editing]] category contains all the articles from the ''Water'' category,
as well as all ''Water tutorial'' articles, plus the ''Water'' and the ''Water Tutorials'' category.
as well as all ''Water tutorial'' articles, plus the ''Water'' and the ''Water Tutorials'' category.


At each point in the category tree the user can thus find '''all'' articles that are are sorted into this category, or she can go to just one subcategory to limit the number of displayed articles.
At each point in the category tree the user can thus find '''all''' articles that are currently in this topic, plus a list of sub-categories. Selecting one subcategory will limit the number of displayed articles to just this sub-category and the contained categories. So going further down, the number of articles will get smaller and smaller until the user reaches the last category.


{{tutorial-wiki}}
{{tutorial-wiki}}

Latest revision as of 17:39, 7 October 2007

Currently, articles are broadly divided into two main types:

  • Tutorials
  • everything else

Tutorials

These are:

  • comprehensive, step-by-step guides,
  • the reader does usually not need to know the topic beforehand to follow the tutorial,
  • they contain more text than just one or two paragraphs
  • they have (preferable) explanatory images

Anything that doesn't really fit as a tutorial is considered to be just an article.

Tagging

Tutorial articles are tagged with templates that start with {{tutorial-, like {{tutorial-water}}.

Everything that doesn't really fit to be a tutorial is tagged with a template that just consists of the topic of the article, like {{textures}} or {{water}}.

While you can add more than one template, you must use only one kind of template to tag articles! See Assigning your Page to a Category for how to do add the correct template.

Category-Tree

Currently, the templates sort articles into categories by the following scheme:

 Documentation
 Tutorial
   Wiki
   Editing
     Water Tutorials
     Texture Tutorials
     ... and so on
 Editing
   Coding
     SDK
     DarkRadiant
     ... and so on
   Textures
     Texture Tutorials
   Texture Tutorials
   Water
   Water Tutorials
   .. and so on
 General
 Universe
 .. and so on
  1. Each category contains all the articles from the sub-categories, too (except the Documentation category).
  2. Each editing subcategory also contains the appropriate tutorial category.
  3. The Tutorial category contains only tutorial articles.
  4. The Editing category contains all editing articles, including tutorials.

This means the Editing category contains all the articles from the Water category, as well as all Water tutorial articles, plus the Water and the Water Tutorials category.

At each point in the category tree the user can thus find all articles that are currently in this topic, plus a list of sub-categories. Selecting one subcategory will limit the number of displayed articles to just this sub-category and the contained categories. So going further down, the number of articles will get smaller and smaller until the user reaches the last category.