Jump to content

Wikipedia:Technical terms and definitions

From Wikipedia, the free encyclopedia
This is an old revision of this page, as edited by Marshman (talk | contribs) at 18:02, 24 August 2003 (DRAFT text for article proposing Style). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.
(diff) ← Previous revision | Latest revision (diff) | Newer revision → (diff)

When writing technical articles, it is usually the case that a number of technical terms or jargon specific to the subject matter will be presented. These should be defined or at least alternative language provided, so that a non-technical reader can both learn the terms and understand how they are used by scientists. It is also the case that such an article can cover a range of related subjects that might not each justify a separate article or Wikipedia page, and therefore making technical terms stand out in the text is the first level in a sequence from definition to subtitle to separate article. On the other hand, do not treat every “scientific” word as a technical term. Ask the question: Is this the only article or one of a very few where the term might be encountered in Wikipedia? Consider the examples presented below.

There are three basic markups used to make technical terms stand out; these are oblique, bold, and bold oblique. The following uses of these styles are recommended for technical articles:

oblique (render by two straight apostrophies); used for:

  • Binomial names of organisms (Genus species) are always italicized; the genus name is first-letter capitalized, the species name is not. Higher systematic levels are NOT italicized, but both the systematic level name and name are first-letter capitalized: Family Poaceae, not family Poaceae.
  • Foreign language words that are not generally used in English: hidari (Jp: "left") but usually not gauche (Fr: "left").
  • Technical or scientific terms that are defined above in the same article (and appear there in bold oblique) to demonstrate use of the term, or emphasize that use to the reader. This would be technical terms that are first defined (or linked to a definition) higher up in the text. Although it is standard practice in text books to put in italics or bold font those words likely to be new to the reader only the first time the word appears, it is helpful to the learning process if newly defined terms that reappear are rendered in oblique font elsewhere in a Wikipedia article.
  • Terms that are not defined at that point in the text, but are nonetheless "technical", although will likely appear in numerous other articles in Wikipedia. Here, the "emphasize only the first time used on a page" rule could apply. Example (from Plant):
Groups at this level of organization, collectively called bryophytes, include….
  • See also: ~ link here to other uses in Style Manual ~

bold (render by three apostrophies)

  • First use of the article name, near the front of the introduction sentence.
  • Definitions that are important aspects discussed by the article, but have not been elevated to the level of subtitle and do not pass the technical term test. Example (from Current (electricity)):
In electricity, current is any flow of charge, usually through a metal wire or some other electrical conductor. Conventional current was defined early in the history of electrical science as a flow of positive charge, although we now know that, in the case of metallic conduction…..

bold oblique (render by five straight apostrophies)

  • First time introduction of a technical term. This should be part of a definition sentence or immediately followed by a non-technical substitute in parentheses. Example (from Fern):
A fern is defined as a vascular plant that reproduces by shedding spores to initiate an alternation of generations. New fronds are formed by circinate vernation.

As in the fern example above, any of the three styles described above could be turned into a link if there exists a more detailed or better explanation of the technical term in a separate article. It may not be necessary then to define the term in the article if a link leads to a definition. However, to aid the reader in continuing with the text without having to leave an article for other details, it might still be appropriate to include a non-technical substitute in parentheses.

Other markups are possible. Examples are technical term (rendered by <tt> and </tt>), underline (rendered by <u> and </u>), and oblique (as rendered by <i> and </i> or <cite> and </cite>). The technical term tag does not produce text sufficiently different from the standard Wikipedia font to be useful. Use of the underline tag can create confusion with links. The HTML tags <i> and <cite> are not differentiated by most common browsers. Use of quotes should also be included or linked here.