CZ:Naming conventions

From Citizendium
Revision as of 10:04, 27 February 2008 by imported>Ro Thorpe (not deliberate)
Jump to navigation Jump to search

We've got various conventions about how to name articles. Maybe most importantly, a word in an article name should be lower case and singular, unless is consistently written in the upper case or plural. Another important convention is that the common names for things should be used in preference to the recondite or obscure, although this may have a few exceptions. See below for details.

How to title articles

It is important to choose the right title for an article.

The title should describe the contents of an article accurately. If you have written an article about a topic, only to discover that your article concerns only one aspect of the topic (such as its history), then it is preferable to place your article on a more accurately-named page, to write a short article about the original topic, and then link from that short article to the new page. For example, if you were to write an article about Russia only to find that you had written exclusively about the history of Russia, then you should move your article to History of Russia, and link to that new page from a brief article about Russia on the Russia page.

Generally, prefer common names. The common names for things--if accurate--should be used in preference to the recondite or obscure (although this may have a few exceptions). For instance, we might better place the article about the 90s U.S. president at Bill Clinton rather than William Jefferson Clinton.

Typographical and stylistic rules

Prefer lowercase except when uppercase is commonly written. The article title should be lowercase.[1] A name which is typically used with title case in a normal sentence should use that form in the article title. So: love and computational complexity theory; but American Chemical Society and Mississippi River. The same applies to subheadings within articles. Aside: content policies such as this one do not necessarily apply to pages that are not in the article namespace. As it happens, most CZ policy pages, e.g. CZ:The_Author_Role, use title case.

Prefer singular. Prefer the singular form of nouns (with few exceptions). For example, prefer bear to bears. This makes articles easier and more intuitive to link to.

First name first. Unless there is a compelling reason not to, articles about people should begin with the person's first name first; e.g., Albert Einstein. Note that there is a way to list names in categories by last name first; e.g., the code [[Category:CZ Live|Einstein, Albert]] files the Einstein article in the "CZ Live" category last name, first.

Disambiguation in page titles

To disambiguate is to reduce ambiguity. It is occasionally necessary to place clarifying phrases within parentheses to specify which of various possible topics might be meant. There are at least two sorts of case in which this is necessary:

  • The title (i.e., the word or phrase in the title) is used in multiple ways, and the sense discussed in the article is not the most common sense. For example, there is a line of cosmetics called "Philosophy"; the article about that might live at Philosophy (cosmetics). The article about deep thought continues to live at Philosophy--no parentheses needed.
  • The title takes a common word or phrase, or what might appear to be common, and uses it in a special way. For example, "attack surface" is a term in computer science, but the words themselves could mean all sorts of things, such as the deck of an aircraft carrier or a ping-pong table. Simply to clarify that we are using the word or phrase in a special way, we include a disambiguating phrase: attack surface (software). More examples: phenomenon (Kant's philosophy); frontal scale (snakes); pissant (insect).

Note: use parentheses for disambiguating phrases; do not use dashes, hyphens, or commas. One exception occurs in geographical place names, in cases where the names are often written with a comma: Anchorage, Alaska.

Some titles should always be disambiguated--in particular, those titles that do not suggest any one particular sense. For example, "Georgia" is apt to bring to mind the U.S. state as much as the country in the Caucasus. Or, in any event, in the interests of neutrality, we should not pretend that one sense is the primary one. Therefore, we should use Georgia (U.S. state) and Georgia (country)--or similar, suitably disambiguated titles. What should we put at Georgia (with no parentheses)? At Georgia, we should put a "disambiguation page," i.e., a page that lists and links to the different pages with the title in question.

Disambiguation pages

The function of a disambiguation page is strictly to list the various articles (including planned articles) that go under a title. Linux (disambiguation) is a good example. Typically, disambiguation pages are marked with "disambiguation" parentheses, but not always; again, Georgia is an example.

Please do not list senses of a word for which there are no articles planned; a disambiguation page is merely a device to redirect people, not to enlighten them about all the different ways that a word or phrase is used. It is also unnecessary to list related articles; for example, it is not necessary to list Linux creator Linus Torvalds on the Linux (disambiguation) page, since Torvalds is not a sense of "Linux." Presumably, people will arrive at the disambiguation page looking specifically for a pointer to an article that goes under the title in question; anything else is a distraction.

If you have a deep burning urge to list everything you can think of that is related to a topic, you don't want to make a disambiguation page. You want to make a Related Articles page (which see).

Geographical entities

These should be written in full, in title case and without a definite article (the): Pacific Ocean, Red Sea, Nile River. Note our usage: Amazon River, not "River Amazon," since the river is usually known by the former name. Generally, we use the name of a geographical entity usually given by the locals if English-speaking, and most often used in English if the locals are not English-speaking. In uncertain cases, some sort of disambiguation should be used in the title.

Notes

  1. The first character is currently "forced" uppercase by our software, but the names of the articles are generally considered to be lowercase: "computer."


Citizendium Content Policy
Approval Standards | Article Mechanics | Subpages | Importing material from other sources | Citable articles
How to Edit
Getting Started Organization Technical Help
Policies Content Policy
Welcome Page