Rules/Categories: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
No edit summary
m (status update)
Line 3: Line 3:
Be sure to also read [[Rules]] and [[Rules/Templates]].
Be sure to also read [[Rules]] and [[Rules/Templates]].


'''Please do not start creating categories now. We would like to have a draft, that majority agrees on, before implementing anything. Renaming categories is hard.'''
'''We're now in the process of categorizing articles. See [[Talk:Rules/Categories/Firefox]] and [[Talk:Rules/Categories/Thunderbird]].'''


==Categorizing articles==
==Categorizing articles==
Line 9: Line 9:
* 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]].
* 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]].
* 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.
* 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.
* 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:Firefox issues]] and [[:Category:Extensions (Firefox)]] (?).
* 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)]].


===Non user support articles===
===Non user support articles===
Line 17: Line 17:
==Creating categories==
==Creating categories==
* 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)]].
* 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)]].
* 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]].
* 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 (ie, we don't want Category:Cookies sitting next to Category:Settings, since cookies are not as general as settings.
* 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".
* "Issues" categories shouldn't have a deep subcategories tree. This means, don't create a subcategory to a subcategory to "Issues".


==Various==
==Various==
* "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.
* "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.

Revision as of 11:28, 19 September 2005

This explains how you should use categories when editing this Knowledge Base. This is work in progress. Discuss these rules on the talk page.

Be sure to also read Rules and Rules/Templates.

We're now in the process of categorizing articles. See Talk:Rules/Categories/Firefox and Talk:Rules/Categories/Thunderbird.

Categorizing articles

  • 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.
  • 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.
  • 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.
  • 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).

Non user support articles

  • Avoid adding development and other non-support articles to user support categories.
  • ...

Creating categories

  • 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).
  • 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

  • "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.