From Nokia Developer Wiki
Jump to: navigation, search

This article explains how to apply categories to your articles, and possibly more important, which categories you should apply.


What categories should I apply?

Windows Phone and Java ME articles are arranged in a category hierarchy which you can navigate to find progressively more (or less) related topics. When adding categories you should seek to add the most specific relevant categories.

Usually an article will include:

Note.pngNote: The legacy platforms (e.g. Symbian and MeeGo Harmattan) have not been ported to a category hierarchy. If you're using these platforms apply framework category (e.g. "Symbian C+"), a technology category (e.g. "Bluetooth"), and version and content type categories.

You can explore the Windows Phone and Java ME category tree below below (note that most of the technology topics are under the tree "General Programming on Platform"

How do I apply categories

The default wiki category selector screen is displayed when you edit an article (shown below). This consists of an Add Categories auto-complete box which will display matching categories for entered text, and a "category selector" from which users can select some of the more common high level categories. Once selected, the article categories are displayed together in the "Categories" list at the top of the selector.

The category selector is a great tool for adding categories - though it is possible that there are other categories or more relevant subcategories that are not presented. In this case you can search for matches using the Add Categories auto-complete box.

Category Selector

The "Category Chooser" link (shown below) can be used to pop up a dialog showing all categories in the wiki.

Category Chooser

Tip.pngTip: You can also add categories using normal wiki syntax. Normally it is easier to use the category selector, except when adding platform version categories


How do I apply the platform-specific technology category?

In general you want to apply the most specific category possible. So for example System Information on Windows Phone‎ rather than parent categories (Base/System on Windows Phone‎‎ -> General Programming on Windows Phone‎ -> Windows Phone‎).

Unfortunately, while the category selector displays most high level categories it doesn't display all of them, or any subcategories. We suggest you browse the full category above and then enter the most specific into the auto-complete. Note that most technology categories are below "General Programming category"

If you can't find a very specific category, add a more general category. The most general categories are "Windows Phone" and "Java ME"

How do I specify the article is in English?

English articles do not need to be given a category, as this is the default.

How do I specify the article natural language?

Articles written in any language other than English should have a language category (e.g. "Lang-Chinese" for Chinese). You can create a new language code if necessary using the prefix "Lang-" and an IETF language code. Note that this wiki does not support dialects so please do not create specific variants of language codes if another already exists.

The most important language communities on the wiki are listed in the category selector "Content Type/Language" column.

When should I apply a platform category?

Articles should include categories for all relevant associated platforms (e.g. Symbian, Maemo, MeeGo, Series 40). For example, a cross platform code example will run on both MeeGo and Symbian, and should have both categories.

Note that if a platform category is not present this does not necessarily imply that the article won't work with that platform. However the presence of a category means that it will. The absence of any platform category should mean that platform is not relevant to the article - but it may mean that the article simply hasn't been categorised yet.

What are Version Categories and how should I apply them?

Platform versions categories are used to indicate whether an article is "known to work" for the specified version. Add the version categories for all platforms that the article has been tested against, or which it would undoubtably work on.

Note.pngNote: If a version category is not present the article may still be relevant to that version, but this is "unknown".

The most recent platform versions for Nokia Asha and Windows Phone are displayed on the category selector, and you can find older version in Windows Phone Platform Versions, Nokia Asha Platform Versions, Symbian Platform Versions

If you have a lot of versions to add you can also add {{VersionHint}} template to a page. Preview the page then copy-paste the relevant categories that are displayed by the template into the page.

What about Symbian and MeeGo

These platforms (other than Java ME topics) have not been migrated to the category hierarchy. If you're working with Symbian development frameworks simply apply development framework and technology tags - for example "Symbian C++" and "Bluetooth". We have created pages for these intersections, which you can usually locate by navigating from the Development Framework category page. For example, see Category:Symbian C++#All Symbian C++ Articles Organized Based on the Topics

Should I apply Qt category to my Qt Quick topic?

No. If its obvious from a subcategory what the parent category is, you should not apply both categories.

How do I create a new category

You can create new categories by entering their name into the "Add Categories" box. Note that you should first confirm that your new category does not exist under a similar name or with a slightly different spelling.