DocWiki:Categories
From DocWiki
(Difference between revisions)
(→Adding Your Categories to the Topic Map: Added more detail) |
|||
| Line 7: | Line 7: | ||
:After saving the category, go to the newly created category and make it a subcategory of Cisco Product, System, or Technology: | :After saving the category, go to the newly created category and make it a subcategory of Cisco Product, System, or Technology: | ||
| - | <nowiki> [[Category:Cisco | + | <nowiki> [[Category:Cisco Products]]</nowiki> |
You can create a nesting of categories on DocWiki. See the flowchart below for the suggested organziation of categories on DocWiki. | You can create a nesting of categories on DocWiki. See the flowchart below for the suggested organziation of categories on DocWiki. | ||
Latest revision as of 13:19, 19 May 2011
Contents |
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 Products]]
You can create a nesting of categories on DocWiki. See the flowchart below for the suggested organziation of categories on DocWiki.
Category Organization
Categories on DocWiki are organized by topics. The following flowchart shows the organization.
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.
Naming Conventions
DocWiki encourages the use of the Wikipedia category naming conventions.
