DocWiki:Categories

From DocWiki

(Difference between revisions)
Jump to: navigation, search
(Guidelines: Updated last bullet)
(Recategorize as DocWiki guideline)
Line 35: Line 35:
See the [http://meta.wikimedia.org/wiki/Help:Category MediaWiki help on Categories] for more information.
See the [http://meta.wikimedia.org/wiki/Help:Category MediaWiki help on Categories] for more information.
-
[[Category:Category Guidelines]]
+
[[Category:DocWiki guidelines]]

Revision as of 21:26, 5 December 2008

Adding Your Categories to the Topic Map

In MediaWiki, you make your category part of a topic map by making it subcategory of that topic.

Put the desired category in your article, using the guidelines below:
  [[Category:example]]
After saving the category, go to the newly created category and make it a subcategory of Cisco Product, System, or Technology:
  [[Category:Cisco Product]]

Category Organization

Categories on DocWiki are organized by topics. The following flowchart shows the organization.

Categories.jpg

Guidelines

Please follow these guidelines for DocWiki categories:

  • Users should tag articles with all appropriate categories (Cisco Products, Technologies). This will allow readers to access content through multiple paths.
  • In general, categories should be as specific as possible. However, sometimes a general category is a better choice than a specific category, depending on the content. Use your discretion.
  • Where applicable, categories should match the name of the lowest applicable level of MDF. If the content here will someday be tied to SupportWiki or Cisco.com, consistent terminology will be important.
  • All pages should be marked with a category.
  • Categories should include more than one article.
  • Do not include "Cisco" in product names for categories. This will cause all products to appear under "C", which defeats the purpose of indexing. However, "Cisco" must be part of the product names in the actual articles. This guideline only applies to categories.
  • The Governance team will review the categories from time to time to see what is being used and to ensure that the categories follow the guidelines.

See the MediaWiki help on Categories for more information.

Personal tools