Rules/Categories: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
m (status update)
m (→‎Other: "pages (like Firefox : FAQs) are to be replaced" -> "pages like Issues with Firefox may be replaced" - see Knowledge Base changes discussion)
 
(26 intermediate revisions by 14 users not shown)
Line 1: Line 1:
This explains how you should use [http://meta.wikimedia.org/wiki/Help:Category categories] when editing this Knowledge Base. This is work in progress. Discuss these rules on the [[Talk:Rules/Categories|talk page]].
{{org}}
This page explains how to use categories when creating new articles for the Knowledge Base. If you're a newcomer to the Knowledge Base and don't want to read through all this just to make a new article, you can leave your article uncategorized (it will then be listed [[Special:Uncategorizedpages|here]]) and someone else will eventually take care of it for you. Discuss these rules on the [[Talk:Rules/Categories|Talk page]]; other pertinent information is in [[Rules]] and [[Rules/Templates]].


Be sure to also read [[Rules]] and [[Rules/Templates]].
==Categorizing articles==
* Each article in the Knowledge Base should belong to one or more categories. To categorize an article, simply insert one or more category tags into the article and save it. A category tag has the form <nowiki>[[</nowiki>Category:''Category name'']], such as <nowiki>[[Category:Profiles]]</nowiki> or <nowiki>[[Category:Issues (Firefox)]]</nowiki>. It's conventional to put category tags at the very bottom of the article.
* A list of categories currently in use can be found on the [[Talk:Rules/Categories|talk page]].
* Put articles into the most specific categories you can. For example, this means that [[:Category:Firefox]] should only contain those articles that couldn't be put into deeper categories such as [[:Category:Extensions (Firefox)]].
* Each article should be put in all categories it belongs to (as many as possible). In particular, all articles in one of the "Issues" categories should also be put into a non&ndash;&ldquo;Issues&rdquo; category. For example, the article &lsquo;[[Lost bookmarks]]&rsquo; belongs to [[:Category:Issues (Firefox)]] and [[:Category:Bookmarks]].
* However, in general, when an article is put into category A, it shouldn&rsquo;t be put into "parent" categories of A. For example, an article in [[:Category:Extensions (Firefox)]] shouldn&rsquo;t also be put into [[:Category:Firefox]].
* Avoid adding [[:Category:Development | development]] and other non-support articles to user-support categories.


'''We're now in the process of categorizing articles. See [[Talk:Rules/Categories/Firefox]] and [[Talk:Rules/Categories/Thunderbird]].'''
==Creating a new (sub)category==
Before creating a new category, please note:
* Names of user support categories should follow the [[article naming conventions]].  When an application name is needed in a subcategory it should be preceded by a dash,  e.g. [[:Category:Startup - Firefox]].
* Avoid creating/using generic categories. E.g. instead of creating a category like "''Category:Miscellaneous (Firefox)''" for articles that don't fit neatly into another category, put/leave  those articles directly in [[:Category:Firefox]].
* In general, avoid creating a new category when there are very few articles to go into it.
* If you're unsure whether to create a new category or if you can't think of a good title for it, use the [[Talk:Rules/Categories|Talk page]] or [[Knowledge Base changes]] to get input from others.


==Categorizing articles==
To create a new subcategory and start using it:
* Each article in the KB must belong to one or more categories. Each category except [[:Category:Top level]] must be a subcategory of one or more other categories.
# In a new or existing article, insert the category tag for the new category (such as "<nowiki>[[Category:Foobar]]</nowiki>") at the end of the article.
* Generally, when an article is put in a category A, it shouldn't be put in "parent" categories of A, i.e. if you put an article in [[:Category:Issues (Firefox)]], you shouldn't also put it in [[:Category:Firefox]].
# Save the article. A link for the new category will now appear at the bottom of the article.
* A related rule: put articles into the most specific categories you can. This means that [[:Category:Firefox]] will only contain those articles that couldn't be categorized better.
# Click on this category link to open the new category page.
* Each article should be put in all categories it belongs too (as many as possible). In particular, all articles categorized in one of "Issues" categories, should also be put in a "non-issue" category. E.g. problems with Firefox extensions go to both [[:Category:Issues (Firefox)]] and [[:Category:Extensions (Firefox)]].
# Edit this category page to make the new category a subcategory of another category, as described below.
# If you were editing an existing article you can now remove the tag for the old subcategory in that article if you wanted to switch it (not just add it) to the new subcategory.
# Continue adding other articles to the new category. You no longer need to click on the category link.
 
==Categorizing categories==
* Each category except [[:Category:Top level]] must be a subcategory of one or more other categories. To make one category a subcategory of another, edit the subcategory page and insert the category tag for the parent category. For example, the page [[:Category:Extensions (Thunderbird)]] has been edited to include <nowiki>[[Category:Thunderbird]]</nowiki>, making it a subcategory of the main "''Thunderbird''" category.  
* Additionally, it is helpful to use the [[Rules/Templates | <nowiki>{{upto}}</nowiki> templates]] to provide another hyperlink from the subcategory to its parent(s).
* Make sure that, in a given category, the immediate subcategories have an approximately equal level of specificity (e.g., we don't want "''Category:Cookies''" sitting next to "''Category:Settings''", since cookies are not as general as settings.
* "Issues" categories shouldn't have a deep subcategories tree. In other words, don't create a subcategory to a subcategory to "Issues".


===Non user support articles===
==Using links and redirects with categories==
* Avoid adding development and other non-support articles to user support categories.
* To link to a category, simply put a colon prior to the word "Category" in the category tag. E.g., <nowiki>[[:Category:Privacy and security]]</nowiki> will produce the link [[:Category:Privacy and security]]. Like with regular [[MozillaZine Knowledge Base:Formatting#URLs.2C_links | internal links]], you could use <nowiki>[[:Category:Privacy and security | this link]]</nowiki> to produce [[:Category:Privacy and security | this link]].
* ...
* See [[Rules/Templates]] for templates that can be convenient for linking to categories.
* This version of MediaWiki (1.5.0) doesn't seem to allow redirecting to a category. [http://bugzilla.wikimedia.org/show_bug.cgi?id=710]
* Likewise, categorizing redirect pages also does not seem to work well. [http://bugzilla.wikimedia.org/show_bug.cgi?id=1476]


==Creating categories==
==Other==
* Names of user support categories should follow the rules for article names. In particular, most subcategories should include application name in parentheses, e.g. [[:Category:Extensions (Firefox)]].
* Eventually, "listing" pages (like [[Issues with Firefox]]) may be replaced with categories. We may use  the editable part of category page to provide a manually sorted listing of pages that belong in that category. The advantage here is that when we put an article in a category, we get a link to the category page for free.
* Avoid creating/using generic categories. Use the most specific category. E.g. instead of putting an article in "''Category:Miscellaneous (Firefox)''", put it directly in [[:Category:Firefox]].
* Make sure that, in a given category, the immediate subcategories have an approximately equal level of specificity (i.e., we don't want Category:Cookies sitting next to Category:Settings, since cookies are not as general as settings.
* "Issues" categories shouldn't have a deep subcategories tree. This means, don't create a subcategory to a subcategory to "Issues".


==Various==
==External links==
* "Listing" pages (like [[Firefox : FAQs]]) are to be replaced with categories. We may use  the editable part of category page to provide a manually sorted listing of pages that belong in that category. The advantage here is that when we put an article in a category, we get a link to the category page for free.
* [http://meta.wikimedia.org/wiki/Help:Category WikiMedia categories]

Latest revision as of 13:22, 25 August 2006

This page explains how to use categories when creating new articles for the Knowledge Base. If you're a newcomer to the Knowledge Base and don't want to read through all this just to make a new article, you can leave your article uncategorized (it will then be listed here) and someone else will eventually take care of it for you. Discuss these rules on the Talk page; other pertinent information is in Rules and Rules/Templates.

Categorizing articles

  • Each article in the Knowledge Base should belong to one or more categories. To categorize an article, simply insert one or more category tags into the article and save it. A category tag has the form [[Category:Category name]], such as [[Category:Profiles]] or [[Category:Issues (Firefox)]]. It's conventional to put category tags at the very bottom of the article.
  • A list of categories currently in use can be found on the talk page.
  • Put articles into the most specific categories you can. For example, this means that Category:Firefox should only contain those articles that couldn't be put into deeper categories such as Category:Extensions (Firefox).
  • Each article should be put in all categories it belongs to (as many as possible). In particular, all articles in one of the "Issues" categories should also be put into a non–“Issues” category. For example, the article ‘Lost bookmarks’ belongs to Category:Issues (Firefox) and Category:Bookmarks.
  • However, in general, when an article is put into category A, it shouldn’t be put into "parent" categories of A. For example, an article in Category:Extensions (Firefox) shouldn’t also be put into Category:Firefox.
  • Avoid adding development and other non-support articles to user-support categories.

Creating a new (sub)category

Before creating a new category, please note:

  • Names of user support categories should follow the article naming conventions. When an application name is needed in a subcategory it should be preceded by a dash, e.g. Category:Startup - Firefox.
  • Avoid creating/using generic categories. E.g. instead of creating a category like "Category:Miscellaneous (Firefox)" for articles that don't fit neatly into another category, put/leave those articles directly in Category:Firefox.
  • In general, avoid creating a new category when there are very few articles to go into it.
  • If you're unsure whether to create a new category or if you can't think of a good title for it, use the Talk page or Knowledge Base changes to get input from others.

To create a new subcategory and start using it:

  1. In a new or existing article, insert the category tag for the new category (such as "[[Category:Foobar]]") at the end of the article.
  2. Save the article. A link for the new category will now appear at the bottom of the article.
  3. Click on this category link to open the new category page.
  4. Edit this category page to make the new category a subcategory of another category, as described below.
  5. If you were editing an existing article you can now remove the tag for the old subcategory in that article if you wanted to switch it (not just add it) to the new subcategory.
  6. Continue adding other articles to the new category. You no longer need to click on the category link.

Categorizing categories

  • Each category except Category:Top level must be a subcategory of one or more other categories. To make one category a subcategory of another, edit the subcategory page and insert the category tag for the parent category. For example, the page Category:Extensions (Thunderbird) has been edited to include [[Category:Thunderbird]], making it a subcategory of the main "Thunderbird" category.
  • Additionally, it is helpful to use the {{upto}} templates to provide another hyperlink from the subcategory to its parent(s).
  • Make sure that, in a given category, the immediate subcategories have an approximately equal level of specificity (e.g., we don't want "Category:Cookies" sitting next to "Category:Settings", since cookies are not as general as settings.
  • "Issues" categories shouldn't have a deep subcategories tree. In other words, don't create a subcategory to a subcategory to "Issues".

Using links and redirects with categories

  • To link to a category, simply put a colon prior to the word "Category" in the category tag. E.g., [[:Category:Privacy and security]] will produce the link Category:Privacy and security. Like with regular internal links, you could use [[:Category:Privacy and security | this link]] to produce this link.
  • See Rules/Templates for templates that can be convenient for linking to categories.
  • This version of MediaWiki (1.5.0) doesn't seem to allow redirecting to a category. [1]
  • Likewise, categorizing redirect pages also does not seem to work well. [2]

Other

  • Eventually, "listing" pages (like Issues with Firefox) may be replaced with categories. We may use the editable part of category page to provide a manually sorted listing of pages that belong in that category. The advantage here is that when we put an article in a category, we get a link to the category page for free.

External links