Misplaced Pages

Revision as of 05:09, 7 September 2007

You may be looking for Misplaced Pages:WikiProject Cats, a wikiproject to organize articles related to felidae and all varieties of cats; Misplaced Pages:WikiProject Categories, a wikiproject to organize categorizing; or Help:Sorting, a page on sortable tables.

This page documents an English Misplaced Pages editing guideline. Editors should generally follow it, though exceptions may apply. Substantive edits to this page should reflect consensus. When in doubt, discuss first on this guideline's talk page.

Shortcut ]

This page in a nutshell: Categories help users navigate through Misplaced Pages via multiple taxonomies Categories are for defining characteristics, and should be specific, neutral, inclusive and follow certain conventions.

For detailed technical information on how to use categories, see Help:Category. For everything you ever wanted to know about categories, see Misplaced Pages:Categorization FAQ.

When to use categories

Categories (along with other features like cross-references, lists, and infoboxes) help users find information, even if they don't know that it exists or what it's called.

Every page in the article namespace should belong to at least one category. Categories should be major topics that are likely to be useful to someone reading the article.

Article: Michael Jackson

Useful category: Category:Pop singers

Not useful: Category:Musicians whose first name starts with M

Questions to ask to determine whether it is appropriate to add an article to a category:

• If the category does not already exist, is it possible to write a few paragraphs or more on the subject of the category, explaining it?
• If you go to the article from the category, will it be obvious why the article was put in the category? Is the category subject prominently discussed in the article?
• Does the category fit into the overall category system? Categories that don't fit are often deleted. To familiarize yourself with the types of categories that routinely get deleted read Misplaced Pages:Overcategorization.

If the answer to any of these questions is no, then the category is probably inappropriate. Note that it is always appropriate to add articles to categories that fit into well established taxonomies. For example, every article about a musical album is categorized in some ] category, which is in turn categorized in Category:Albums by artist.

Guidelines

Some general guidelines

1. Categories are mainly used to browse through similar articles. Make decisions about the structure of categories and subcategories that make it easy for users to browse through similar articles.
2. An article will often be in several categories. Restraint should be used as categories become less effective the more there are on any given article.
3. Articles should usually not be in both a category and its subcategory. For example, Golden Gate Bridge is in Category:Suspension bridges, so it should not also be in Category:Bridges. However, there are occasions when this guideline can and should be ignored. For example, Robert Duvall is in Category:Film actors as well as its subcategory Category:Best Actor Academy Award winners. See #5 for another exception. For more about this see Misplaced Pages:Categorization and subcategories
4. Check to see where siblings of the article reside. If there are few if any articles in a category, the article probably belongs in one of the subcategories.
5. Articles should be placed in categories with the same name. However, the article and the category do not have to be categorized the same way. The article can also be placed in categories populated with similar articles. The category can be put into categories populated with similar subcategories. For an example of this, see George W. Bush and Category:George W. Bush.
6. There are often occasions when articles might ideally be moved from a category to two or more of its subcategories, but not all of the subcategories exist. In such cases consider creating the additional subcategories, but if you decide to not do so, leave the articles in the parent category for the time being.
7. Bend the rules above when it makes sense, but only if no other solution can be found.
8. Categories appear without annotations, so be careful of NPOV when creating or filling categories. Categories that are not self-evident, or are shown through reliable sources to be controversial, should not be included on the article; a list might be a better option.
9. An article should normally possess all the referenced information necessary to demonstrate that it belongs in each of its categories. Avoid including categories in an article if the article itself doesn't adequately show it belongs there.
10. If you don't know where to put an article, don't worry about it. Instead of adding a category, use the {{uncategorized}} tag to bring attention to the article. Editors who love to categorize articles will find a good home for your article.

Categories vs. Lists vs. Info boxes

Categories are not the only way to organize articles. For alternative methods of grouping articles, and the circumstances in which they should be used, see Misplaced Pages:Categories, lists, and series boxes.

Categories applied to articles on people

A separate wikipedia page Misplaced Pages:Categorization of people was created to help you in designing, applying and checking categories that are used for articles on people.

Categories do not form a tree

Each Misplaced Pages article can appear in more than one category, and each category can appear in more than one parent category. Multiple categorization schemes co-exist simultaneously. In other words, categories do not form a strict hierarchy or tree structure, but a more general directed acyclic graph (or close to it; see below).

Nevertheless, parts of the category graph will be tree-like, and it may be convenient to think of parts of the category graph as being like multiple overlapping trees. When applying the guidelines above, consider each tree to be independent of the overlapping trees. A person browsing through a hierarchy should find every article that belongs in that hierarchy. This can lead to a good deal of debate as to what the hierarchies actually are. To clarify the structure of the hierarchy and help people browse through it, you can add a classification to each category. For more about this, see Misplaced Pages:Classification.

Cycles should usually be avoided

Although the MediaWiki software does not prevent cycles (loops), these usually should be avoided. Cycles can be confusing to some readers, they can challenge some automated searching processes, and they can grow quite large. For example, in January 2006, a 22-member category cycle was discovered and eliminated.

However, acceptable loops also exist. Self-referencing systems such as the meta- fields naturally create cycles that provide many examples. This type of cycle involves making a category one of its own subcategories. A real-world example of a self-referencing system is “education about education,” such as:

Classification: Education: Social sciences: Academic disciplines: Academia: Education: ...

Another type of cycle involves making two categories subcategories of each other. Loops such as these can be avoided by linking the categories manually to each other by adding "See also:Category:Foo" to each category page. For an example of this see Category:World Trade Center and Category:September 11, 2001 attacks.

How to categorize an article

Categorizing an article is simply performed by editing it to include one or more category declarations. For instance, to add Felis silvestris catus article to the "fluffy creatures" category, you would edit the article and enter ] at the bottom, but before any stub templates and interlanguage links. The appeal of categories is that unlike lists, they update themselves automatically, and you don't have to edit the category to add an article to it. However, categories are not a substitute for lists, and you will find that many articles belong to both lists and categories.

When adding an article to a category, or creating categories, one should be careful to use the correct categories and subcategories. Horizontal categorization, directly below, refers to placing an article in the correct category while vertical categorization refers to placing an article in the correct subcategory.

When assigning an article into categories, try to be thorough in a "horizontal" sense. The topic may be associated with a geographic area, a historical period, an academic subfield, a certain type of thing (like a food or an ornament), and/or a special interest topic (like Roman Empire or LGBT). You might need to poke around the category hierarchy a bit to find the right place. Try searching for articles similar to the article you are categorizing to get ideas or to find the most appropriate place.

In the "vertical" dimension, Misplaced Pages has traditionally been more frugal, placing articles only in the most specific categories they reasonably fit in. Thus, if there is a Category:American film actors, John Wayne would go there and not in Category:Film actors or Category:American actors. However, there is a school of thought that argues that, because different users may be interested in different categories, and because placing articles in multiple categories takes up minimal additional space, in some cases one should place articles in all the categories that apply.

For more about this see Misplaced Pages:Categorization and subcategories

How to create categories

Creating a category is as simple as adding a link to a category that doesn't yet exist. For instance, to create the "fluffy creatures" category, you would edit an article and enter ] the same way as adding it to any other category. The Category:Fluffy creatures will automatically be created when the edit is saved.

Category naming

Categories follow the same general naming conventions as articles, for example do not capitalize regular nouns. For specific conventions related to categories, see Misplaced Pages:Naming conventions (categories). Whatever categories you add, make sure they do not implicitly violate the neutral point of view policy. If the nature of something is in dispute (like whether or not it's fictional or scientific or whatever), you may want to avoid labelling it or mark the categorization as disputed. Most categorizations are pretty straightforward, though.

Look before you leap

Before creating a category, look to see if one already exists. The best way to do this is to first add the category to your article but preview before saving. When previewing a page, scroll right to the very bottom of the browser window to see the categories. If the category appears in blue, the category already exists. If it is in red, then you will be creating a new category. Check the capitalization of the category name. For any red categories, you should look for categories with similar names before creating a new category. One way to do this is to think of the parent category for the new category. Search for it and then look at the subcategories in the parent. You may find that a category already exists that is similar to the one you are thinking about creating.

Before creating a new category, familiarize yourself with all the guidelines on this page, and related pages. Pay particular attention to the established naming conventions for categories. Categories are deleted, merged and renamed at Misplaced Pages:Categories for discussion. For more about types of categories that may be likely to get deleted, see Misplaced Pages:Overcategorization.

You may see some inconsistencies when first creating the category: it may alternate between appearing empty and appearing with your first additions. It will probably correct itself in a few minutes. Note that, although "uncreated" categories will correctly list articles that have been assigned to them, the category page itself does not exist until it is manually created. The easiest way to create the category page is to follow the red category link from your article and create a new category page with a parent category and a category description as explained in the next section.

How to create subcategories

Subcategories may be created by putting ] onto the page that you would like to make into a subcategory. This may seem counterintuitive, because you edit the subcategory page rather than the parent category page.

Let's say that you wanted to make the category called Roses into a subcategory of the category called Flowers.

Step 1 - Go to the page called ], and click edit this page.

Step 2 - Place the text ] within the body of the ] article, and save.

Finished! Roses is now a subcategory of Flowers, and ] will be visible on ].

When writing the description for a category try to give it at least two parent categories. For example, Category:British writers should be in both Category:Writers by nationality and Category:British people. A few categories do only merely subdivide their parent category, but unless the parent category has many potential articles under it, or many potential subdivisions, if you can't think of a second parent category, it might be a better idea to fold your smaller category into the parent.

How to delete a category

Please refer to Misplaced Pages:Categories for discussion

How to rename a category

Please refer to Misplaced Pages:Categories for discussion

Organizing categories

Large categories

When there are more than 200 entries in a category, only 200 are displayed on the screen and users have to click through multiple screens to see all the entries. To make it easy to navigate, add a TOC (table of contents). TOCs are added by typing:

{{CategoryTOC}} - which adds a complete TOC (Top, 0 - 9, A-Z)

{{CatAZ}} - which adds a TOC without numbers. This is for categories with members that only start with letters.

Another possibility is dividing the category into several subcategories. Note that there is no technical consideration, policy or guideline requiring that large categories must be divided into smaller subcategories. When creating subcategories, group similar articles together in a meaningful and useful way that will make it easy for readers to navigate later. Remember that several subcategorization schemes can coexist (for example, if Category:Software gets too big, you don't have to choose between subdividing it by function or subdividing it by platform, you can simultaneously subdivide it in both ways).

How to depopulate a very large category

If you decide that a large category should be depopulated and the entries re-categorized into sub-categories, add this template to the category page:

{{Verylarge}}

For large categories that will require continual diffusion into sub-categories (such as categories of people), add this template to the category page:

{{catdiffuse}}

Also, the names of all subcategories may not show in the first display of a multi-screen category listing. To make all next level sub-categories immediately visible, add this code to the page as well:

<categorytree>Category name</categorytree>

Grouping categories

A set of related categories often forms a hierarchy or a nexus. This can take several different forms, all of which are welcome and encouraged:

• A taxonomic grouping. For example, Category:South Asian countries is part of a geographical hierarchy. Category:Academic disciplines catalogs divisions between fields of study.
• A functional grouping. Examples: Category:Ancient Rome, Category:World War II, and Category:Commercial item transport and distribution. These bring together articles and subcategories from different fields or taxonomies (history, war, culture, people, companies, industries, technologies) that have an interesting common thread.
• Hybrid forms. For example, Category:Art is both part of the taxonomy of Category:Academia and a cross-reference point for lots of things that have little in common except that they have something to do with art.
• Offshoot forms. For example, Category:Film stubs contains subcategories of Category:Comedy film stubs for comedy films, and Category:Drama film stubs for drama films.

Other requirements

Misplaced Pages namespace

Categories relating to the Misplaced Pages namespace should be added only to the talk page of articles. For example, tags suggesting the article needs work would be placed on the talk page as they are relevant to editors and not an aid to browsing in the way ordinary categories are.

User namespace

Categories relating to the User namespace should be added only to Misplaced Pages-specific categories. Users should not add their user pages to article namespace categories such as Category:People or other subcategories, Category:Biologists etc, which are reserved for pages in the article namespace. However, it is appropriate to add a user page to Misplaced Pages-specific categories such as the subcategories of Category:Wikipedians (though not directly to Category:Wikipedians itself), e.g. Category:Wikipedian musicians. (See also m:Help:Category for guidelines on category "pollution").

If you copy an article to your user namespace (for example, as a temporary draft or in response to an edit war) you should decategorize it in one of the following ways, (where foobar is the category name):

1. ], note the extra : before Category.
2. {{cl|foobar}}, see {{cl}}
3. {{ccl|foobar}}, see {{ccl}}
4. {{lcs|foobar}}, see {{lcs}}

Image namespace

See categorizing images for information on how to categorize images. For a place to start, see Category:Images by subject or its parent category Category:Misplaced Pages images. You may need to navigate the category hierarchy to find the appropriate category.

Keep cats out of the sandbox

Categories should not be put on articles that you are working on in the sandbox, nor on any page that you are using as a sandbox (such as an article draft that you are writing in a subpage of your userspace). In such cases you can add <nowiki> before the categories and </nowiki> following them, so that they will display without creating category listings. When the draft becomes an actual article you can remove the markup.

Links to categories

You can create a link to a category page without adding the page to that category by using a colon before the word Category. Example: ] appears as Category:Automotive technologies.

In some cases, particularly in the middle of a category tree, it is helpful to use the template:cat see also to expose the existence of important sub-categories lower down in the hierarchy. This prevents newer editors from incorrectly adding articles to a higher category level, and readers in locating such. On particularly well-populated categories, it can be used to bring the default skin's 'parent categories' (which display at the page bottom) up above the page lists to ease navigation. The similar template {{Cat see also commons}} can be utilized on lower level categories to give editors and browsing customer readers ready access to commons subtrees. (See Category:Munich for an example.)

Redirected categories

Although it is possible to attempt to redirect categories by adding a line such as #REDIRECT ] to a category, it is not generally recommended because of limitations in the mediawiki software. Categories "redirected" in this way do not prevent the addition of articles to the redirected category. Articles added to the "redirected" category do not show up as in the target category. Until these issues are addressed (in future versions of the software), #REDIRECT should not be added to category pages.

"Soft" redirects for categories can be created using {{Category redirect}}. A bot traverses categories redirected in this manner moving articles out of the redirected category into the target category, see Template talk:Category redirect.

Category sorting

Pipe tricks and sort keys

Contrary to some expectations, text after a pipe ("|") in a category link is not used in place of the category text. Rather, this text is used as the sort key on the category page itself. However, again contrary to expectations, that sort text is not displayed. One common application is to ignore "The" in article names, so ] will make "The Beatles" list under B rather than T in the category.

As another example, the Category:Three-digit Interstate Highways uses this property to sort secondary interstates by their primary. That is, the category link in the article for Interstate 190 (South Dakota) is ]. This causes "Interstate 190 (South Dakota)" to be listed right after "Interstate 190 (New York)" and right before "Interstate 290 (Illinois)" under the heading "9" in the category page.

This feature is very useful for categories in which:

• the entries are people, in which case sorting by last name is preferable (example: Category:Presidents of the United States).
• variations in the naming of entries causes inconsistent sorting (example: List of counties in Nebraska, List of counties in Montana, but List of Nevada counties in Category:Lists of U.S. counties).
• the logical sort order is not alphabetical (example: individual month articles in year categories such as Category:2004, using e.g. the sort key "*2004-04" for April).
• entries may begin with a definite (the) or indefinite (a, an) article. (example: book titles such as The Maltese Falcon should be sorted simply as Maltese Falcon).

Using this method to sort category entries is sometimes informally referred to as the pipe trick. However, this use of the pipe character is very different from the original MediaWiki pipe trick which allows one to easily hide parenthetical disambiguation in links.

Sort key shortcuts

Setting a default sort key

The default sort key of a page for categories can be changed using the {{DEFAULTSORT}} magic word. For instance, on George Washington, {{DEFAULTSORT:Washington, George}} would cause a subsequent ] to be equivalent to ], not ]. This is especially useful when the article belongs in many categories. If more than one default sort key magic word is present on a page, the last occurrence is the one used. The default sort key can be overridden for individual categories applied to an article by manually applying a sort key.

In the absence of a {{DEFAULTSORT}}, the default sort key is the article title. It is therefore not technically necessary to provide a {{DEFAULTSORT}} value if the article title is the desired default sort key. However, it is still a good idea to provide an explicit {{DEFAULTSORT}} in these cases. Explicitly stating a default sort key is preferable to having no default sort key, as this leaves a record of the decision that the title is the sort key. Leaving it blank means that later editors cannot tell which articles have been checked for default sort and which have not. Also, some editing tools, notably AWB, will attempt to infer an appropriate {{DEFAULTSORT}} value if one is not provided. For example, the most appropriate default sort key for Acacia acanthoclada is the article title, yet that article is also in Category:Acacia with the sort key "Acanthoclada". If "Acacia acanthoclada" is not explicitly declared the default sort key, then AWB may declare the default sort key to be "Acanthoclada".

The default sort magic word is sometimes mistaken as a template. Template:DEFAULTSORT exists to correct such mistakes, but it should not be used. All tranclusions of the template in articles should eventually be replaced by the magic word.

Priority sort keys

It is possible to force an article or subcategory to the top of the list by using a non-alphanumeric character as the first after the pipe. For example, using ] (note the space) or ] would force that article to be displayed before all the others. Many editors feel that the space character produces the best aesthetic appearance when the category is displayed. Using a space or asterisk after the pipe is the customary way to categorize an article in a category with the same name, indicating that the article is the main topic article for that specific category. For an example, see Category:Suspension bridges. Using {{Catmore}} may be preferable - no consensus has been established yet. To list at the end (after z) of a category, the sort key ~ can be used ].

Sorting with templates

Occasionally, categorization is done with a template. This can be done by adding a category to the template itself, which will then add to that category all pages on which the template is transcluded. This is usually reserved for pages not in the article namespace, such as talk, project, or user pages. In such cases, it is often desirable to use the magic word {{PAGENAME}} to define a generic sort key that removes the namespace, so that the transcluded pages will be sorted by the page name instead. In one example, a WikiProject (such as WikiProject Architecture) may wish to categorize relevant articles into the project category (Category:Unassessed Architecture articles) by placing the {{Architecture}} template on the relevant talk pages (such as Talk:Bonus room). Using {{PAGENAME}} as the category sort key for the template will avoid having all pages sorted by the "Talk" namespace. In our example, the page would then appear sorted by the page name only ("Bonus room") instead of by the complete name including namespace ("Talk:Bonus room").

Other specifics

• For more detailed guidelines about sorting names of people, see Misplaced Pages:Categorization of people#Ordering names in a category.
• Don't start the category sort key with a lower case letter, unless you want to create a separate caption with that lower case letter in the category (note that the first lower case letter caption starts only after the last upper case letter caption)
• When trying to sort with numbers (e.g. wikipedia:Naming conventions (pieces of music)), don't forget to add an extra zero when more than 9 entries in the category are expected; and a second extra zero when more than 99, etc...: ] → ] (he wrote 108 symphonies). Categories sort by the first character, so leaving out the preceding zero would cause 10 to be sorted before 2.
• Ordinals often have to be converted to Arabic numerals: e.g. Pope John IX: ] (+ zero added, there are XXIII popes with the name John)

Year categories

See also Misplaced Pages:naming conventions (numbers and dates)#Articles on other standard time periods

In categories which are years, such as Category:2004, special sorting guidelines apply:

• Entries should generally be sorted by topic, so the article 2004 in film, for example, would contain the category reference ] while 2004 Canadian budget would contain the reference ]; List of religious leaders in 2004 would contain ].
• The article about the year itself, 2004, should be sorted first among all articles by using a space ].
• Articles for individual months, such as October 2004, should be sorted chronologically in the first section on the category page, in this case using ].

Interlanguage links to categories

Interlanguage links work just as they do for regular articles; ] in Category:Mathematics connects to the German counterpart. This can be a useful way to compare coverage, or to look for articles in need of interlanguage links. Note that the different languages may have adopted different standards and practices for categorization, so a given category might not exist in other languages.

Tools

• Pearle can be used to automatically move articles from one category to another, get dumps of the category trees, and accomplish some other useful category-related tasks.

Current projects

See: Misplaced Pages:Categorization projects (current)

Known category-related bugs

Please report new category-related bugs on bugzilla and list them below.

(Bugs higher than 1775 have not been checked)

Redirects

• Categories need piping feature to list by alternative name (to show redirects next to the articles they redirect to in categories, when appropriate)
• Problem categorizing redirects

Special:Categories

• Link to Special:Categories should be customisable
• Special:Categories should be paged by letter, like Special:Allpages

Large categories

• Dealing with large categories
• On paged categories, article totals and subcat totals are incorrect
• Subcategory paging is not separate from article paging
• Table of contents for Categories

Updating problems

• changes to links in a template do not update 'links', 'categorylinks', etc for pages including it

General

• Add anchor tags to the headers used on category pages
• Characters in category names
• uncategorized pages report speedup hack
• Categories need to be structured by namespace
• Ability to filter user contributions by time (e.g. "January 2003") or category
• syntax to transclude a page without the containing page inheriting categories, interlanguage links
• Category page listings have unbalanced columns
• automatic edit summary for categorizing pages
• RSS feed for category updates
• Whitelist doesn't work correctly for categories
• Feature request: boolean search in categories
• Page move updates categories with sorting tweak
• Feature request: Category reverse sort by date
• Korean wikipedia's categories need new sectioning scheme
• Ability to watch all articles in a category
• can't edit the history versions of the categories!
• Request: parameters in categories

See also

Browsing categories

• Misplaced Pages:Browse - A large navigation page that includes links to high-level categories
• Special:CategoryTree Category Tree browser
• Cat Scan

• Special:Categories - Lists all existing categories alphabetically.
• Category:Categories - List of top-level categories. Requires this category be defined on the top of a tree.
• Category:Fundamental - Fundamental knowledge categories.

Maintenance

• Misplaced Pages:Categories for discussion
• Special:Uncategorizedpages
• Special:Uncategorizedimages
• Special:Uncategorizedcategories
• Special:Unusedcategories
• Special:Wantedcategories
• Special:Mostlinkedcategories

Other

• Help:Category
• Misplaced Pages:Categorization FAQ
• m:Categorization requirements (original guidelines for category proposals and implementations)
• Category:Knowledge representation - Material related to concept categorization.
• Misplaced Pages:Category intersection, proposal
• s:EB1911:Classified table of contents — Introduction (Wikisource) Technique of categorization for the 1911 Britannica
• Misplaced Pages:Categorization/Gender, race and sexuality
• Misplaced Pages:Categories, lists, and series boxes

• Misplaced Pages editing guidelines
• Misplaced Pages categorization
• Misplaced Pages how-to