CZ:Naming conventions: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Larry Sanger
No edit summary
imported>Larry Sanger
Line 19: Line 19:
To "disambiguate" is to reduce ambiguity.  It is occasionally necessary, or advisable, to use parenthetical phrases to specify ''which'' of various possible phrases might be meant.  There are at least two sorts of case in which this is advisable:
To "disambiguate" is to reduce ambiguity.  It is occasionally necessary, or advisable, to use parenthetical phrases to specify ''which'' of various possible phrases might be meant.  There are at least two sorts of case in which this is advisable:


* 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 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]].
* The title takes a common phrase, or what might appear to be a common phrase, but which is used 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)]].  Another example: [[phenomenon (Kant's philosophy)]].
* The title takes a common phrase, or what might appear to be a common phrase, but which is used 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)]].  Another example: [[phenomenon (Kant's philosophy)]].
Some titles that 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.  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.,
=== Disambiguation pages ===

Revision as of 16:16, 23 April 2007

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. The article title should be lowercase unless it is typically written uppercase when used in a regular sentence. So: computational complexity theory; but American Chemical Society.

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.

Use natural phrases, not punctuation. (to expand)

Disambiguation in page titles

To "disambiguate" is to reduce ambiguity. It is occasionally necessary, or advisable, to use parenthetical phrases to specify which of various possible phrases might be meant. There are at least two sorts of case in which this is advisable:

  • 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.
  • The title takes a common phrase, or what might appear to be a common phrase, but which is used 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). Another example: phenomenon (Kant's philosophy).

Some titles that 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. 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.,

Disambiguation pages