CZ:Definitions: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Larry Sanger
imported>Larry Sanger
Line 11: Line 11:
== Format standards ==
== Format standards ==


It is easy to locate a definition for a given term, if it exists.  If an article is titled [[Topic]], then you may find the template at [[Topic/Definition]].  But you really do not need to know this; the correct subpage name is created by the "Definition" link in the subpage tab, as well as the {{Tl|r}} template (see [[CZ:Related Articles|Related Articles]] and [[Template:R]] for more information).
It is easy to locate a definition for a given term, if it exists.  If an article is titled [[Topic]], then you may find the definition at [[Topic/Definition]].  But you really do not need to know this; the correct subpage name is created by the "Definition" link in the subpage tab, as well as the {{Tl|r}} template (see [[CZ:Related Articles|Related Articles]] and [[Template:R]] for more information).


=== Format of the definition itself ===
=== Format of the definition itself ===

Revision as of 10:57, 16 May 2008

What are definitions in the Citizendium?

The Citizendium uses definitions in two different places. The first, discussed in Article Mechanics, are in articles, typically stated in the first sentence. The second, which we discuss here, are created using subpages of the form [[Term/Definition]]. The latter are "definition subpages."

Definition pages actually serve as reusable templates provide a brief (no more than 30 word/100 character) account of the meaning of a concept, or a pithy description of a particular topic.

Purpose

Definitions pages are used primarily on Related Articles pages; the latter consist of lists of term-definition pairs. When exploring the Citizendium's article offerings on Related Articles pages, we believe end users will find it useful to have definitions, especially of unfamiliar terms.

Format standards

It is easy to locate a definition for a given term, if it exists. If an article is titled Topic, then you may find the definition at Topic/Definition. But you really do not need to know this; the correct subpage name is created by the "Definition" link in the subpage tab, as well as the {{r}} template (see Related Articles and Template:R for more information).

Format of the definition itself

Only a few remarks are necessary about the format of the definition. In the following, suppose just for the sake of illustration that "knowledge" is defined as "Justified, true belief."

  • Limit your definition to 100 characters (ignoring formatting like [[]] and ''''). Ten words or fewer is adequate in many cases.
  • Do not repeat the term defined. So, do not write: "Knowledge is justified, true belief." Write: "Justified, true belief."
  • Begin the definition with a capital letter, and end with a period. So, do not write "justified, true belief" (lower case "j" and without a period). Write: "Justified, true belief."
  • If you must use two sentences, divide them by a semicolon, not a period.
  • Do not leave any extra blank lines after the definition. The contents will be very short.
  • Do not add categories, images, templates, or other bells and whistles to the definition page. The definition page must be reusable in, potentially, many different contexts, so it should be as stripped-down as possible.

How to display a definition

You may easily display a definition by following this pattern. Typing (note the curly brackets {{ }} as well as the preceding colon (:) )

{{:Philosophy/Definition}}

produces

The study of the meaning and justification of beliefs about the most general, or universal, aspects of things.

Simply put in, for "Philosophy" in the above, the exact name of the article whose definition you want to display. If no definition for the term exists, create one. Go to the article, click on the "Definition" tab (it must have subpages), and type in your definition.

Guidelines for editing

Definitions should be created in the context of Related Articles pages; see our guidelines for creating such pages to get started.

See above for guidelines about the "physical" format of the definition.

Some general hints:

  • Do not describe the article; define the concept, or describe the thing, that the article describes.
  • Avoid jargon wherever possible; a definition's purpose is supposed to be useful to people who don't already know the meaning of the word defined. You defeat this purpose if you use even more obscure jargon to explain a piece of jargon.

When you are ready to craft a definition, examine whether the term to be defined is general and so describes many things (like "book"), or particular and so describes just one thing (like The Grapes of Wrath). Then consider the standards for definitions and for descriptions below.

Standards for good definitions

If the term is general, it is subject to definition (rather than description). In most cases, a classic genus-and-difference definition would work fine. Here are some rules taken from a standard logic text for such definitions:

  • Rule 1: A definition should state the essential attributes of the concept (i.e., of the thing defined).
  • Rule 2: A definition must not be circular.
  • Rule 3: A definition must be neither too broad nor too narrow.
  • Rule 4: A definition must not be expressed in ambiguous, obscure, or figurative language.
  • Rule 5: A definition should not be negative where it can be affirmative.

Standards for good descriptions

Strictly speaking, it is impossible to define the names of particular persons, places, and things, like "Paris, France." Instead we say that we make pithy descriptions of these things. Here are some guidelines:

  • For famous persons and landmarks, include what the item is best known for: "Madonna (singer): Pop music icon of the 1980s, known especially for her sexy/trashy image."
  • For persons, provide dates of birth and death in parentheses: "Amelia Earhardt: (1897-1937) Famous American female aviation pioneer."
  • For places, specify an encompassing geographical entity or a nearby landmark, and if that is generally obscure, also provide the name of an encompassing entity that is probably familiar: "Wiesbaden: Capital of the state of Hesse, Germany; pop. about 275,000."


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