Shortcut: WD:D

Help:Description

From FAMEData
Jump to navigation Jump to search

Template:DescriptionLanguages Template:Guideline

Wikidata screenshot - description field highlighted
There can be multiple items with the same label in Wikidata; descriptions disambiguate the labels

The description on a Wikidata entry is a short phrase designed to disambiguate items with the same or similar labels. A description does not need to be unique; multiple items can have the same description, however no two items can have both the same label and the same description.

Please note: this page describes the use of descriptions for items only. While properties have descriptions, their primary purpose is not to disambiguate labels; instead, they provide a brief synopsis or further details on how a property should be used (and do not necessarily follow the below stylistic conventions to do so). For more information about descriptions for properties, see Help:Properties.

Language-independent general principles

Help:Description/general principles/en

Guidelines for descriptions in English

These guidelines apply to descriptions in English. Speakers of other languages may define guidelines for their language. Until that happens, the guidelines for English can be used as a starting point to the extent that they make sense and are useful for the individual language.

Length

Descriptions are not full sentences, but small bits of information. In most cases, the proper length is between two and twelve words. One-word descriptions are almost always too ambiguous, and should be avoided. If the description goes onto a second line it is probably too long, and if it goes onto a third line, it is almost definitely too long.

Common formulas

Generally, a good starting point for a description is the class the item is an instance of (if any).

These serve as good starting points, however you should not feel bound to them.

Capitalization

Descriptions begin with a lowercase letter except when uppercase would normally be required or expected. Essentially, you should pretend that the description is appearing in the middle of a normal sentence, and then follow normal language rules. Most terms would not be capitalized if they appeared in the middle of a sentence. However terms such as proper nouns (e.g. the names of specific people, specific places, and specific titles) should be capitalized.

Examples:

Label: Lionel Messi
Description: footballer from Argentina
This example begins with a common noun (footballer) that is not usually capitalized in the middle of a sentence, so its first letter is not capitalized here either. Argentina is a proper noun, and therefore its first letter is capitalized.

Label: Sunflower Galaxy
Description: spiral galaxy in the constellation Canes Venatici
This example begins with an adjective (spiral) that is not usually capitalized in the middle of a sentence, so its first letter is not capitalized here either.

Label: John Smith
Description: English botanist, first curator of Kew gardens (1798–1888)
This example begins with a demonym (English), an adjective that is always capitalized in the middle of a sentence, so the first letter is capitalized here too.

Punctuation

Descriptions are not full sentences, and should not end in periods/full stops. This is not a license to ignore punctuation entirely; if a description should have commas in it, those should be included. Wikidata takes no position whether the serial comma should be used or not used. Both "red, white, and blue" (the serial comma is after white) and "red, white and blue" (no serial comma) are acceptable in the English language. The serial comma is a contentious issue, so you should respect the initial description writer's choice to include or not include it. You do not need to reiterate the subject in the description, as it is already in the label.

Examples:

Label: Miami
Description: city in southern Florida, United States
The description does use a comma, separating the state from the country, which is normal in the English language. It is not a complete sentence and does not have a period.

Label: Yoko Ono
Description: artist, author, and peace activist from Japan
This description uses a serial comma. This description could also be written without the comma after the word author, and it would be correct in the English language.

No initial articles (a, an, the)

Descriptions should not normally begin with initial articles (a, an, the). In the English language, there are some phrases that require an initial article, and in those cases you can use the initial article; however, if it is not needed, it should not be used.

Example:

Label: Dwyane Wade
Description: basketball player from the United States
Ordinary cases do not have an initial article. In this case, "a" is the proper initial article, and it is omitted.

Go from more specific to less specific

Descriptions should start with the more specific information first. When dealing with locations, for example, this might mean beginning with the municipality and ending with the country.

Examples

Label: Arcenillas
Description: municipality located in Zamora, Castile and León, Spain
In general use the local government hierarchy of names to go from more specific to less specific (Zamora is in Castile and León, which is an autonomous community in Spain). Names are separated by commas only rather than descriptions (leave out 'province of' in front of Zamora).

Label: Velika Polana
Description: town in Velika Polana municipality, Slovenia
"Municipality" included here for the first level only to distinguish the town from the municipality.

Guidelines for descriptions in Swedish

In contrast to the English language, the Swedish language have two different grammatical genders (utrum and neutrum). So, for completeness Swedish descriptions should contain the appropriate initial article. This makes the descriptions usable outside Wikidata in compliance with Wikidata:Data access/sv.

How to query them in sparql

    ?item schema:description ?itemdesc.
    FILTER(LANG(?itemdesc) = "nl")

See also

For related Help pages, see:

  • Help:Items, which explains what items are and what rules they follow
  • Help:Label, which explains what labels are and what rules they follow
  • Help:Aliases, which explains what aliases are and what rules they follow
  • Help:Statements, which explains what statements are and what rules they follow

For additional information and guidance, see: Help links

Maintenance