Category talk:Categories

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m (Typo)
m (Applications: update)
 
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
For the Openmoko wiki to be organized effectively it must use a good hierarchy of categories.
+
Okay I think we have sanitized the top-level structure, but lots remains to be done !
 +
* Multilinguism
 +
* Categorizing [[Templates]] (not started)
 +
* Categorizing [[Special:Uncategorizedpages| uncategorized pages]] (mostly done)
 +
* Categorizing [[Special:Uncategorizedcategories|uncategorized categories]] (almost complete, waiting on multilinguism)
 +
* Recategorizing poorly categorized pages (ongoing task, waiting on categorization to settle)
 +
* Rewriting the category pages text (waiting on categorization to settle)
 +
* Some more shuffling around subcategories remains to be done
 +
* Clickable tree is ugly/less functional than directory-style list of subcategories (but automatic ? discussing values and goals)
 +
* Clean the Wiki Issue page of Categorization talk too (mostly done)
 +
* Integrate with the Wiki-wide navigation system (left column, main page, navboxes)
 +
* Besides "Distributions" the name of top level categories are all questionable
 +
** Rename "Community" as "People" and move "Openmoko Inc." there ? (btw there is no 'move' for categories, only create new / move content / delete old)
 +
** Is "Maturity level" as self explining as I think it should be ?
  
Getting things better organized will take time.  An ideally organized hierarchy may not be possible right away, but significant improvements can still be made working from the existing structure.
+
So much work, so little time !
  
A few principles should guide the reorganization:
+
[[User:MinhHaDuong|MinhHaDuong]] 07:47, 13 September 2008 (UTC)
 +
Updated: [[User:MinhHaDuong|MinhHaDuong]] 06:53, 14 September 2008 (UTC)
  
#'''A category in which almost everything could be placed is not helpful.'''  Such categories do not distinguish one page from another and thus do nothing to classify the pages or tell the wiki user what sort of page to expect to find in such a category.  There is already a site-wide [[Openmoko_Wiki_Official_Index_Page|index]] that lists every page in the wiki, so multiple categories that achieve the same thing are a duplicative waste.  Thus, the existing categories [[:Category:Information|Information]] and [[:Category:Openmoko|Openmoko]] are prime examples of categories that are currently overbroad.  Everything on the wiki is "information" so do not put pages in such a category.  It's not a helpful label and every page currently in that category should be re-categorized into a more specific category.  Also, everything on the wiki is related to "Openmoko" so putting every page in that category would also be a waste.  However, if we redefine what kinds of pages are appropriate to the [[:Category:Openmoko|Openmoko]] category, this could still be a useful category.  (See below).  Additionally, the category [[:Category:Categories|Categories]] could be applied to every category in the wiki, so again, that's not a useful categorization, and the [[:Category:Categories|Categories]] category should really be renamed "Top Level Categories" and only such top-level categories put in there.  Again, we already have an auto-generated list of [[Special:Categories|every category on the wiki]], so a special category to generate such a list is not needed and would be duplicative.
+
== Moved here from [[Wiki Issues]] ==
#'''Users should be able to browse the category pages as a useful way of navigating the wiki.'''  Users should not be forced to rely on the search functionality of the wiki or on links from existing pages in order to find additional information.  Instead, they should be able to navigate the various category pages in order to learn what all the wiki has to offer.  If these category pages are over-cluttered or fail to contain relevant pages, then it makes it harder for users to find information on the wiki.
+
[[User:MinhHaDuong|MinhHaDuong]] 14:36, 13 September 2008 (UTC)
#'''In general, a wiki page should be placed in the most specific subcategory in which it appropriately fits.'''  So, e.g., there are several hundred geographically-based [[Openmoko_Local_User_Group|Local Groups]].  Those pages should be placed in the subcategory [[:Category:Openmoko Local Groups|Openmoko Local Groups]] and not in the broader [[:Category:Community|Community]] category.  Which leads to:
+
#'''Typically, a wiki page should NOT be placed in every category in which it could conceivably fit.'''  So, e.g., if those hundreds of local user groups were to also be in the [[:Category:Community|Community]] category (as they used to be) then when one visits the [[:Category:Community]] page, one is totally overwhelmed by the giant list of local user groups and it is hard to find anything else community-related.  There will be exceptions to this where, instead, it makes sense to list a page in multiple categories, but think about this carefully before putting pages in numerous categories in which they don't really fit.
+
  
So, if we were starting the wiki from scratch, we might choose a different organization, but, given that the wiki already contains thousands of pages, we can start the process of improving the organizational structure by working with what we have. That existing structure currently best lends itself to the following set of top-level categories:
+
===General issues with categories===
 +
* Please read wikipedia [http://en.wikipedia.org/wiki/Wikipedia:Categorization Categorization] page and [http://en.wikipedia.org/wiki/Wikipedia:FAQ/Categorization FAQ]
 +
* There are way too many [[Special:Categories| categories]].
 +
* There should be only one category taxonomy for the "Neo type" with subcategories "FreeRunner", "Neo1973", "GTA03"... Otherwise, categories should not include the Neo type.
 +
* Another big taxonomy can be based on the layers model. "Chips", "Drivers", "Operating system", "Framework", "Applications"
  
*[[:Category:Hardware|Hardware]]
+
=== The Ideas category ===
*[[:Category:Software|Software]]
+
[[Category:ideas|Ideas]]
*[[:Category:Community|Community]]
+
1. Many pages have  Wishlist:   in the title. This syntax is potentially confusing because there is no Wishlist: namespace. TEH BOT did a mass rename from "Wishlist:(.*)" to "Wishlist/\1" ? Thanks.
*[[:Category:Openmoko|Openmoko]] (the corporation)
+
*[[:Category:Documentation|Documentation]]
+
*[[:Category:Help|Help]] (Use & Maintenance of the Wiki itself)
+
  
Almost everything that could go into the wiki can appropriately be broadly categorized as falling into one of these.  Pages about the handheld devices are largely about either hardware or software.  Pages related to the people using and working on those devices are either related to people that work for Openmoko the corporation or are related to the user/developer community.  The primary point of the wiki is to serve as documentation, so it seems an important top-level category too.  Finally, some people will always need help understanding what a wiki is, how to use it, what the syntax for editing pages is, or how to get involved with [[Wiki_Maintainers|maintaining]] and contributing to the wiki, so some Help pages should be prominent and easy to find.
+
2. A significant minority of pages in the "Category:ideas" are missing the prefix in the title.
  
Note that in the above, the currently overbroad [[:Category:Openmoko|Openmoko]] category is redefined to be specifically a counterpart to the [[:Category:Community|Community]] category. Instead of listing every single page about the Openmoko software distribution (which can be better categorized under the [[:Category:Software|Software]] category) the [[:Category:Openmoko|Openmoko]] category can include pages about the corporation, e.g., History, Employees, Legal, Sales, Sponsored Events, etc.
+
3. There are two templates, { { Wishlist } } and { { Unimplemented } } . We agreed on the ML (10/9/08 IIRC) that it is unnecessary redundancy.
  
If one looks at the [[:Category:Categories|Categories]] category right now (August 2008) it roughly approximates this structure. By pressing the + button next to each top-level category one can see the 2nd-level subcategories under each and even those are beginning to have an almost reasonable structure.  Work remains to be done. Individual pages and even category pages need to be categorized or recategorized to fit into something approximating this structurePlease join the effort with the above principles in mind. Once we get a mostly usable wiki we can think about a larger overhaul that might improve the existing structure, but for now, we need to just get the thing where people can actually find all the useful information that is buried in this wiki.
+
=== The test category ===
 +
[[Category:Test|Test]]  
 +
Is it organized and how ? [[User:MinhHaDuong|MinhHaDuong]] 10:11, 25 September 2008 (UTC)
 +
 
 +
Can we move these pages under a new subcategory of Test ?
 +
* http://wiki.openmoko.org/wiki/Kuai_Yi_Dian_GM519
 +
* http://wiki.openmoko.org/wiki/Compulab_EM-X270
 +
* http://wiki.openmoko.org/wiki/IPhone
 +
* [[G1]]
 +
[[User:MinhHaDuong|MinhHaDuong]] 14:41, 25 September 2008 (UTC)
 +
 
 +
=== The Neo1973 Hardware category ===
 +
[[Category:Neo1973 Hardware|Neo1973 Hardware]]
 +
Lots of legacy subcategories, but interesting content.
 +
 
 +
=== Category structure discovering and planning ===
 +
 
 +
This is a discovery of the category structure around 8/9/08 and notes about how it should be changed. Please contribute, add your comments what should be changed and how. Thanks, [[User:Kempelen|Kempelen]]
 +
 
 +
===[[:category:Applications|Applications]]===
 +
 
 +
Software programs for the Openmoko smartphones.  When there are some more articles in one specific type create a subcategory for it. When you add an application to a subcategory, do not add it to the main. [[User:Kempelen|Kempelen]]
 +
 
 +
* [[:Category:Audio Applications|Audio Applications]] (freedesktop: yes)
 +
* [[:category:GPS Applications|GPS Applications]] (freedesktop: no)
 +
* [[:category:Gaming|Gaming]] (freedesktop: as "Game", propse renaming to "Games")
 +
* [[:Category:Graphics Applications|Graphics Applications]] (freedesktop: yes)
 +
* [[:category:Internet Applications|Internet Applications]] (freedestkop as "Network" which would conflict with [[:category:Networking]])
 +
* [[:category:Office Applications|Office Applications]] (freedesktop: yes)
 +
* [[:category:Server|Server]] (one single article!) (freedesktop: no)
 +
* [[:category:Settings Applications|Settings Applications]]  (freedesktop: yes)
 +
* [[:Category:System Applications|System Applications]] (freedesktop: yes)
 +
* [[:category:Telephony|Telephony]]  (GSM, GPRS, SMS..) (freedesktop: no)
 +
* [[:Category:Utility Applications|Utility Applications]] (freedesktop: yes)
 +
* [[:Category:Video Applications|Video Applications]] (freedesktop: yes)
 +
 
 +
===[[:category:Host OSes|Host OSes]]===
 +
 
 +
This could be in some subcategory, but there is no good place.
 +
 
 +
===[[:category:Community|Community]]===
 +
 
 +
Community involvement
 +
 
 +
* [[:Category:Business|Business]]
 +
* [[:Category:Community Update|Community Update]]
 +
* [[:category:Event|Event]]
 +
* [[:Category:Group Sales|Group Sales]]
 +
* [[:category:OpenLab|OpenLab]]
 +
* [[:Category:Openmoko Local Groups|Openmoko Local Groups]]
 +
* [[:Category:Purchase|Purchase]]
 +
* [[:Category:Wiki Editing|Wiki Editing]]
 +
** [[:Category:Candidates for speedy deletion|Candidates for speedy deletion]]
 +
** [[:Category:Improve]]
 +
 
 +
===[[:Category:Phones|Phones]] ===
 +
 
 +
* [[:category:GTA03|GTA03]]
 +
* [[:category:GTA04|GTA04]]
 +
* [[:category:Neo FreeRunner Hardware|Neo FreeRunner Hardware]]
 +
* [[:category:Neo1973 Hardware|Neo1973 Hardware]]
 +
** [[:category:Neo1973 Phase 0 related|Neo1973 Phase 0 related]]
 +
** [[:category:Neo1973 Phase 1 related|Neo1973 Phase 1 related]]
 +
** [[:category:Neo1973 Hardware Debugging|Neo1973 Hardware Debugging]]
 +
** [[:category:Neo1973 alternate cases|Neo1973 alternate cases]]
 +
** [[:category:Neo1973 and external hardware|Neo1973 and external hardware]]
 +
 
 +
===[[:category:Hardware|Hardware]]===
 +
 
 +
Functional subsystems. :) Descriptions of various hardware components. Kernel driver info and other software for the hardware component (in subcategories).
 +
 
 +
* [[:category:Accelerometer|Accelerometer]]
 +
* [[:category:Audio|Audio]]
 +
* [[:category:Battery|Battery]]
 +
* [[:category:Bluetooth|Bluetooth]]
 +
* [[:category:CPU|CPU]]
 +
* [[:category:Chip|Chip]]
 +
* [[:category:Debug Board|Debug Board]]
 +
* [[:category:Diagram|Diagram]]
 +
* [[:category:Flash|Flash]]
 +
* [[:category:GPS|GPS]]
 +
* [[:category:GSM|GSM]]
 +
* [[:Category:Hardware ideas|Hardware ideas]]
 +
** [[:Category:Neo1973 alternate cases|Neo1973 alternate cases]]
 +
* [[:category:Networking|Networking]]
 +
** [[:category:Standard|Standard]]
 +
** [[:category:Protocol|Protocol]]
 +
* [[:category:Used chip|Used chip]]
 +
* [[:category:USB|USB]]
 +
* [[:category:Vibrator|Vibrator]]
 +
 
 +
===[[:category:Distributions|Distributions]]===
 +
 
 +
* [[:category:Angstrom|Angstrom]]
 +
* [[:category:Debian|Debian]]
 +
* [[:category:FSO|FSO]]
 +
* [[:category:Framework|Framework]]
 +
* [[:category:Om 2007.2|Om 2007.2]]
 +
* [[:category:Om 2008.8|Om 2008.8]]
 +
* [[:category:Qtopia|Qtopia]]
 +
* [[:category:SHR|SHR]]
 +
 
 +
===[[:category:Guides|Guides]]===
 +
 
 +
General documentation categorized by target audience. The Guides root should not contain articles.
 +
 
 +
* [[:Category:Advanced End User|Advanced End User]]
 +
** [[:Category:Flashing Openmoko|Flashing Openmoko]]
 +
* [[:Category:Application Developer|Application Developer]]
 +
** [[:Category:D-Bus|D-Bus]]
 +
** [[:Category:Diagram|Diagram]]
 +
** [[:Category:Emulation|Emulation]]
 +
** [[:Category:Framework|Framework]]
 +
** [[:Category:User Interfaces|User Interfaces]]
 +
* [[:Category:Basic End User|Basic End User]]
 +
** [[:Category:Add-on data|Add-on data]]
 +
** [[:Category:Carriers|Carriers]]
 +
** [[:Category:Profile|Profile]]
 +
* [[:Category:System Developers|System Developers]]
 +
** [[:Category:Emulation|Emulation]]
 +
** [[:Category:Framework|Framework]]
 +
** [[:Category:Kernel|Kernel]]
 +
** [[:Category:Test]]
 +
*** [[:Category:Development Board|Development Board]]
 +
*** [[:Category:Hardware Test|Hardware Test]]
 +
*** [[:Category:Software Test|Software Test]]
 +
** [[:Category:User Interfaces|User Interfaces]]
 +
 
 +
===[[:Category:Maturity Level]]===
 +
 
 +
* [[:Category:Ideas|Ideas]]
 +
** [[:Category:Hardware ideas|Hardware ideas]]
 +
*** [[:Category:Neo1973 alternate cases|Neo1973 alternate cases]]
 +
** [[:Category:Software ideas|Software ideas]]
 +
* [[:Category:Implemented|Implemented]]
 +
* [[:Category:In progress|In progress]]
 +
* [[:Category:Progress unknown|Progress unknown]]
 +
* [[:Category:ToDo|ToDo]]
 +
* [[:Category:Unimplemented|Unimplemented]]
 +
 
 +
Applications category contains subcategories for various application groups, like GPS, Networking... This may be a problem if e.g. GPS belongs to Applications and Hardware too (and most of these stuff will belong to both). Maybe we could simply add articles to Applications AND GPS, which won't be subcategories of each other. [[User:Kempelen|Kempelen]] 20:54, 29 August 2008 (UTC)
 +
 
 +
Basic End User and Advanced End User categories have been created instead User, which was not enough specific term. (And contained only WishList items!) [[User:Kempelen|Kempelen]]
 +
 
 +
== Archived discussions ==
 +
 
 +
[[/archive1| Archived 2008-09-12 : discussions leading to the recategorization of categories]]

Latest revision as of 20:48, 25 September 2008

Okay I think we have sanitized the top-level structure, but lots remains to be done !

  • Multilinguism
  • Categorizing Templates (not started)
  • Categorizing uncategorized pages (mostly done)
  • Categorizing uncategorized categories (almost complete, waiting on multilinguism)
  • Recategorizing poorly categorized pages (ongoing task, waiting on categorization to settle)
  • Rewriting the category pages text (waiting on categorization to settle)
  • Some more shuffling around subcategories remains to be done
  • Clickable tree is ugly/less functional than directory-style list of subcategories (but automatic ? discussing values and goals)
  • Clean the Wiki Issue page of Categorization talk too (mostly done)
  • Integrate with the Wiki-wide navigation system (left column, main page, navboxes)
  • Besides "Distributions" the name of top level categories are all questionable
    • Rename "Community" as "People" and move "Openmoko Inc." there ? (btw there is no 'move' for categories, only create new / move content / delete old)
    • Is "Maturity level" as self explining as I think it should be ?

So much work, so little time !

MinhHaDuong 07:47, 13 September 2008 (UTC) Updated: MinhHaDuong 06:53, 14 September 2008 (UTC)

Contents

[edit] Moved here from Wiki Issues

MinhHaDuong 14:36, 13 September 2008 (UTC)

[edit] General issues with categories

  • Please read wikipedia Categorization page and FAQ
  • There are way too many categories.
  • There should be only one category taxonomy for the "Neo type" with subcategories "FreeRunner", "Neo1973", "GTA03"... Otherwise, categories should not include the Neo type.
  • Another big taxonomy can be based on the layers model. "Chips", "Drivers", "Operating system", "Framework", "Applications"

[edit] The Ideas category

1. Many pages have Wishlist: in the title. This syntax is potentially confusing because there is no Wishlist: namespace. TEH BOT did a mass rename from "Wishlist:(.*)" to "Wishlist/\1" ? Thanks.

2. A significant minority of pages in the "Category:ideas" are missing the prefix in the title.

3. There are two templates, { { Wishlist } } and { { Unimplemented } } . We agreed on the ML (10/9/08 IIRC) that it is unnecessary redundancy.

[edit] The test category

Is it organized and how ? MinhHaDuong 10:11, 25 September 2008 (UTC)

Can we move these pages under a new subcategory of Test ?

MinhHaDuong 14:41, 25 September 2008 (UTC)

[edit] The Neo1973 Hardware category

Lots of legacy subcategories, but interesting content.

[edit] Category structure discovering and planning

This is a discovery of the category structure around 8/9/08 and notes about how it should be changed. Please contribute, add your comments what should be changed and how. Thanks, Kempelen

[edit] Applications

Software programs for the Openmoko smartphones. When there are some more articles in one specific type create a subcategory for it. When you add an application to a subcategory, do not add it to the main. Kempelen

[edit] Host OSes

This could be in some subcategory, but there is no good place.

[edit] Community

Community involvement

[edit] Phones

[edit] Hardware

Functional subsystems. :) Descriptions of various hardware components. Kernel driver info and other software for the hardware component (in subcategories).

[edit] Distributions

[edit] Guides

General documentation categorized by target audience. The Guides root should not contain articles.

[edit] Category:Maturity Level

Applications category contains subcategories for various application groups, like GPS, Networking... This may be a problem if e.g. GPS belongs to Applications and Hardware too (and most of these stuff will belong to both). Maybe we could simply add articles to Applications AND GPS, which won't be subcategories of each other. Kempelen 20:54, 29 August 2008 (UTC)

Basic End User and Advanced End User categories have been created instead User, which was not enough specific term. (And contained only WishList items!) Kempelen

[edit] Archived discussions

Archived 2008-09-12 : discussions leading to the recategorization of categories

Personal tools

For the Openmoko wiki to be organized effectively it must use a good hierarchy of categories.

Getting things better organized will take time. An ideally organized hierarchy may not be possible right away, but significant improvements can still be made working from the existing structure.

A few principles should guide the reorganization:

  1. A category in which almost everything could be placed is not helpful. Such categories do not distinguish one page from another and thus do nothing to classify the pages or tell the wiki user what sort of page to expect to find in such a category. There is already a site-wide index that lists every page in the wiki, so multiple categories that achieve the same thing are a duplicative waste. Thus, the existing categories Information and Openmoko are prime examples of categories that are currently overbroad. Everything on the wiki is "information" so do not put pages in such a category. It's not a helpful label and every page currently in that category should be re-categorized into a more specific category. Also, everything on the wiki is related to "Openmoko" so putting every page in that category would also be a waste. However, if we redefine what kinds of pages are appropriate to the Openmoko category, this could still be a useful category. (See below). Additionally, the category Categories could be applied to every category in the wiki, so again, that's not a useful categorization, and the Categories category should really be renamed "Top Level Categories" and only such top-level categories put in there. Again, we already have an auto-generated list of every category on the wiki, so a special category to generate such a list is not needed and would be duplicative.
  2. Users should be able to browse the category pages as a useful way of navigating the wiki. Users should not be forced to rely on the search functionality of the wiki or on links from existing pages in order to find additional information. Instead, they should be able to navigate the various category pages in order to learn what all the wiki has to offer. If these category pages are over-cluttered or fail to contain relevant pages, then it makes it harder for users to find information on the wiki.
  3. In general, a wiki page should be placed in the most specific subcategory in which it appropriately fits. So, e.g., there are several hundred geographically-based Local Groups. Those pages should be placed in the subcategory Openmoko Local Groups and not in the broader Community category. Which leads to:
  4. Typically, a wiki page should NOT be placed in every category in which it could conceivably fit. So, e.g., if those hundreds of local user groups were to also be in the Community category (as they used to be) then when one visits the Category:Community page, one is totally overwhelmed by the giant list of local user groups and it is hard to find anything else community-related. There will be exceptions to this where, instead, it makes sense to list a page in multiple categories, but think about this carefully before putting pages in numerous categories in which they don't really fit.

So, if we were starting the wiki from scratch, we might choose a different organization, but, given that the wiki already contains thousands of pages, we can start the process of improving the organizational structure by working with what we have. That existing structure currently best lends itself to the following set of top-level categories:

Almost everything that could go into the wiki can appropriately be broadly categorized as falling into one of these. Pages about the handheld devices are largely about either hardware or software. Pages related to the people using and working on those devices are either related to people that work for Openmoko the corporation or are related to the user/developer community. The primary point of the wiki is to serve as documentation, so it seems an important top-level category too. Finally, some people will always need help understanding what a wiki is, how to use it, what the syntax for editing pages is, or how to get involved with maintaining and contributing to the wiki, so some Help pages should be prominent and easy to find.

Note that in the above, the currently overbroad Openmoko category is redefined to be specifically a counterpart to the Community category. Instead of listing every single page about the Openmoko software distribution (which can be better categorized under the Software category) the Openmoko category can include pages about the corporation, e.g., History, Employees, Legal, Sales, Sponsored Events, etc.

If one looks at the Categories category right now (August 2008) it roughly approximates this structure. By pressing the + button next to each top-level category one can see the 2nd-level subcategories under each and even those are beginning to have an almost reasonable structure. Work remains to be done. Individual pages and even category pages need to be categorized or recategorized to fit into something approximating this structure. Please join the effort with the above principles in mind. Once we get a mostly usable wiki we can think about a larger overhaul that might improve the existing structure, but for now, we need to just get the thing where people can actually find all the useful information that is buried in this wiki.