* 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"

−

#'''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.

+

=== The Ideas category ===

−

#'''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.

+

[[Category:ideas|Ideas]]

−

#'''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 [[:Category:Openmoko Local Groups|Openmoko Local Groups]] and not in the broader [[:Category:Community|Community]] category. Which leads to:

+

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.

−

#'''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:

+

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

−

*[[:Category:Hardware|Hardware]]

+

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

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.

+

=== The test category ===

+

[[Category:Test|Test]]

+

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

−

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.

+

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)

−

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

+

=== The Neo1973 Hardware category ===

+

[[Category:Neo1973 Hardware|Neo1973 Hardware]]

+

Lots of legacy subcategories, but interesting content.

−

----

+

=== Category structure discovering and planning ===

−

A way to give a semblance of logic to the categories list would be to rename "Community" to

+

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]]

−

"Wetware". Then we create a top level category "Vaporware". Category "Todo" goes under, as well as "Ideas" which is currently under "Community". Pages in "Legal" could go under "Openmoko Inc." [[User:MinhHaDuong|MinhHaDuong]] 16:47, 4 September 2008 (UTC)

+

+

===[[: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]]

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 19:48, 25 September 2008

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

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

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

Views

Personal tools

This category is the "Main category". It should not contain articles directly and it should contain only the global categories, like Software, Hardware, etc. Kempelen

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, but significant improvements can still be made working from the existing structure.

A few principles should guide the reorganization:

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.

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.

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:

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.

A way to give a semblance of logic to the categories list would be to rename "Community" to
"Wetware". Then we create a top level category "Vaporware". Category "Todo" goes under, as well as "Ideas" which is currently under "Community". Pages in "Legal" could go under "Openmoko Inc." MinhHaDuong 16:47, 4 September 2008 (UTC)