Advanced Technical Writing University of Idaho
 
Start Here
Course Content
Resources
Help
Contact
Blackboard

 

Sitemap
 

 

© 2006 Phil Druker
University of Idaho
 
ResourcesDefinitions
 

 


Resources

General
Definitions
Graphic Aids
How to Summarize
Paragraphs
Plagiarism
Writing Process

Outlines

Sentence Style

Formatting

Citing Sources

 

 

Definitions

Definitions are a basic part of technical writing. In fact, most technical writing is a kind of definition
bullet

Software documentation is a definition of the software.

bullet

A report on soil run off is a definition.

bullet

A manual on how to use spectrometer is a definition.

Here are some basic ideas on definition:

Why define terms?

bullet

Most technical writing involves definition in some form.

bullet

Jargon turns readers off (unless they know what it means).

bullet

Readers need to know how you are using terms.
bullet

Definitions assure readers you and they understand the term in the same way.

bullet

Definitions clarify terms for the general audience.

bullet

Definitions define terms for contractual purposes.

Who is your audience?

bullet

Analyze / know your readers’ level of expertise

bullet

Meet your readers’ needs.

bullet

Define terms as needed (consider your purpose).

What makes a good definition?

  1. Meet your readers’ needs: right level of technicality.

  2. Use plain English.
    bullet

    Lower the level of technicality. (Don’t use jargon to define jargon.)

  3. Explain the basic properties:
    bullet

    function 
    bullet

    what it does

    bullet

    how it works

    bullet

    form
    bullet

    what it looks like

    bullet

    what are the parts

  4. Be objective.

  5. Be accurate

How long should the definition be?

bullet

Parenthetical (part of a sentence)

Example:
Larch, larix laricina occidentalli, is a species commonly occurring in North Idaho.
bullet

a deciduous conifer,

bullet

a cone bearing tree that looses its needles,

Sentence Definition (might be a couple sentences)

Term   = class (genus)   +
(what kind of thing is it?)
distinguishing features 
(be specific: show how it differs from others in the class)
“telephone” electronic communications device Connected through a network


Extended definition (paragraph, chapter,….)

 

 

Start Here  |  Content  |  Resources  |  Help  |  Contact |  Home Utilities 

Phil Druker © 2006  

 

University of Idaho
Environmental Science Program
Advanced Technical Writing

thompson@uidaho.edu