Book Contents

Home

Section I

Chapter 1:
Scientific and Technical Communication in Context
Part 1; Part 2; Part 3

Chapter 2:
Reading Scientific and Technical Texts

Chapter 3:
Writing Scientific and Technical Texts
Part 1; Part 2; Part 3

Chapter 4:
Conducting Research
Part 1; Part 2

Chapter 5:
Understanding Audiences
Part 1; Part 2

Chapter 6:
Persuasion and Critical Thinking
Part 1; Part 2

Chapter 7:
Participation and Policy
Part 1; Part 2

Section II

Chapter 8:
Definitions, Descriptions, and Instructions
→ Part 1; Part 2

Chapter 9:
Correspondence

Chapter 10:
Job-Finding Materials

Chapter 11:
Proposals
Part 1; Part 2

Chapter 12:
Technical Reports

Chapter 13:
Scientific Articles and Abstracts

Chapter 14:
Oral Presentations

Chapter 15:
Formatting, Designing, and Using Graphics
Part 1; Part 2

Grammar Handbook

Section III

Chapter 16:
Opening
Geoff Cooper:
"Textual Technologies"
Discussion

Chapter 17:
Opening
Steve Fuller: "Putting People Back Into the Business of Science"
Part 1; Part 2
Discussion

Chapter 18:
Opening
William Keith: "Science and Communication"
Discussion

Chapter 19:
Opening
Sujatha Raman: "Challenging High-Tech War"
Discussion

Chapter 20:
Opening
Dale L. Sullivan: "Migrating Across Disciplinary Boundaries"
Discussion

Chapter 21:
Opening
Tobias, Chubin, Aylesworth: "Restructuring Demand for Scientific Expertise"
Part 1; Part 2
Discussion

Introduction

Definition and description play important and fundamental roles in scientific and technical communication. Definitions are basic, and usually brief. A parenthetical one-word definition of constriction might follow the term's first use in a emergency first-aid manual: "(narrowing)." A one-sentence definition of iodine might appear in a chemistry handbook: "a lustrous, grayish, corrosive element having radioactive isotopes." Descriptions are longer. A description of the surface of Venus might take four pages of an eight-page scientific article. A description of a new design for a suspension bridge might compose a major section of an engineering firm's proposal. And a description of carbon dating might occupy half a chapter of an archeology textbook.

Definition

Definitions are brief statements which specify the basic qualities of their subject. An author using definitions needs some idea of the background of her audience. For instance, an author of an article submitted to a journal in architecture probably does not need to define "traverse" -- the common architectural term for structural crosspiece. But the author of an article in a newspaper should define the term because it is not in the layperson vocabulary. Likewise, an author of an article in a professional field other than architecture should define it simply as a precaution: various disciplines have assigned different meanings to the same term. (In fact -- in navigation, a traverse is a zigzag course forced by contrary winds; in surveying, a traverse is a line established by sighting; in law, to traverse is to make a formal denial of an allegation in a suit.)

When you have established the need for a definition, you must decide whether the definition should be informal or formal.

Informal Definitions

An informal definition offers the reader only what she needs to know, and does not impede the narrative. It is introduced as part of a larger presentation of an argument or a concept. It appears as one or more words in parentheses immediately following the term, or as a sentence or paragraph containing the term. An informal definition is useful when you want your audience to focus only on a certain aspect or aspects of the term.

The following selection, adapted from a college textbook in physical anthropology, uses several informal definitions.

The first paragraph is devoted entirely to a definition of a closed call system. Within the paragraph is a parenthetical informal definition of bands -- a term simply and quickly defined, but necessary to the larger definition. (Notice that the author does not think it necessary to explain primate -- the passage is from a central chapter in the book, and the author has by now used the term often.) A longer informal definition of open call system occupies the entire second paragraph, which contains a shorter formal definition of phoneme. Because the author borrows the term phoneme from linguistics, he is careful to spend more than a sentence explaining it.

Formal Definitions

A formal definition identifies its subject within a larger group, and differentiates it from others in that group. It is useful in several circumstances.

A formal definition may appear as a self-contained paragraph, a footnote or endnote, or, as in this example, as part of a table:

Clouds are classified into four families distinguished by their height above ground: high clouds (cirrus or cirro-form clouds), middle clouds (given the prefix "alto"), low clouds, and clouds with vertical development (cumulus or cumuloform clouds). High clouds, usually composed entirely of ice crystals, generally occur at altitudes ranging from 20,000 to 40,000 ft. Middle clouds may have bases between about 8,000 ft. and 20,000 ft.

Family
Genus
Species
Description
HIGH CLOUDS 16,500 to 45,000Cirrus---Wispy, hair-like clouds. Formed of delicate filaments, feetpatches, narrow bands, or feather-like plumes.
---Cirroculumlus--- Thin, white, grainy, and rippled patches or sheets or layers. Show very slight vertical development in the form of turrets and shallow towers.
---Cirrostratus--- Transparent, hair-like or smooth whitish veil. Covers all or part of the sky. Produces halo phenomenon.
MIDDLE CLOUDS 6,500 to 23,000 feet Altocumulus---Extensive sheet of regularly arranged white and gray, somewhat rounded cloudlets.
------Altocumulus castellanusAltocumulus with vertical development in the form of small towers or turrets. Elements have a common horizontal base and appear to be arranged in lines.
------Altocumulus lenticularis A patch of altocumulus in the shape of a lens or almond. Often stationary and very elongated with well-defined outlines.

The classifications family, genus and species are borrowed from biology.

Since Adam, many groups have named and classified life forms -- sometimes with peculiar results. There is, for instance, the case of the large South American rodent called the capybara. In the 16th Century Venezuelans and Columbians, who found its meat delectable, petitioned the Pope to decree it a fish, thus allowing them to enjoy it during Lent. He did, and Roman Catholics are still permitted to eat capybara without breaking the Lenten fast.

Law has also been much involved in classification. The Animal Welfare Act, which regulates the use of animals in experiments, defines animal as "any live or dead dog, cat, monkey ... or such other warm-blooded animal as the Secretary may determine is being used, or intended for use, for research." In other words, the Secretary may define what an animal is. In recent years more common laboratory specimens -- mice and rats -- have not enjoyed legal protection because, under the Animal Welfare Act, they are not animals. Animals rights activists and others -- suggesting that the definition is shaped by economics (protection would require inspection, and inspection would cost $1 million a year) -- have made numerous appeals.

Description

Descriptions are detailed definitions. As an author of descriptions, you need first to discover what your audience needs to know about the subject. The way it works internally? What it produces? What it looks like? Description formats may be determined by their subject:

Functional Descriptions

A functional description discusses a machine or tool in terms of the work it performs. A functional description might be used in an application for a machine patent directed to the patent office, the introduction of a device addressed to a scientist who needs to use it to perform an experiment, or a catalogue entry directed at consumer who might wish to buy it. Although few functional descriptions in real technical communication appear independently of other description, we need to be able to separate the functional aspect of the tool in question from the physical aspect if only to make clear our understanding of the tool, and if only to gain some control over our choice of detail. Such separation, in other words, is a useful exercise. To distinguish a tool's functional nature from its physical nature can be difficult. You will make your work easier by omitting details of shape, size, and material, unless they are necessary to the device's function. Concentrate instead on the work the tool performs, and the method by which the work is performed.

A format for a functional description includes:

Combining these elements, we produce the following definition of scissors:

Every part of the description contributes to our understanding of the work the device performs, and how the device performs it. This type of description is called blue-sky -- which is to say, it may include the largest possible variety of devices termed "scissors." Because the description mentions neither materials nor size, and because it makes the receiver of the work ambiguous, it may include both tin snips used by machinists and the plastic scissors used by schoolchildren. Note too that the description makes no mention of handles, and so may include scissors whose blades are held apart by a springed hinge and closed by the manual application of pressure directly on the dull outside edge of the blades.

A less expansive description -- which we might term a limited description -- would simply add details to the same format. A limited description of common household scissors might be:

An inventor applying for a machine patent is likely to be acutely conscious of the advantages and disadvantages of blue-sky and limited definitions. A description that is too broad may seem to include a machine already in existence; a description that is too narrow may not protect the inventor from a patent claim whose subject is actually her invention altered slightly. The solution is to combine the most useful aspects of each type of definition. An inventor applying for a machine patent of, for instance, a watch, might describe it as:

The description terms the watch "semi-automatic" because it requires periodic winding. The description avoids words like "hands" and "face" and phrases like "tells time" because they are so colloquial as to impart no real information. The description terms the dial "suitably circumscribed" so that it may include twenty-four hour military clocks, and terms the dial "actual or implied" to include designer watches with blank or transparent dials.

Applicants for patents, of course, are not the only authors of functional descriptions, and not the only authors who need to adjust their descriptions to their audience. An author of a non-technical dictionary might describe a calculator as follows:

Physicists and engineers call this a "black box" definition. The phrase refers to a mechanism or part of a mechanism whose inner workings are either not understood, or do not need to be understood. The description would be useful to a generalist, not so useful to an engineer -- who might prefer this limited description from a technical handbook:

Physical Descriptions

A physical description discusses an object in terms of its composition and/or appearance. It might be used in an application for a design patent, a list of specifications addressed to builders, the presentation of a new product to a corporate board of directors, or the description of a section of woodland for a builder's Environmental Impact Statement.

Although many descriptions in scientific and technical communication use visual aids, they are greatly clarified by accompanying narratives, and have limitations which only narratives can overcome. In certain cases -- if, for instance, the printing budget prohibits it, or if the communication is done over the telephone or with someone visually disabled -- communication will depend entirely upon words.

The difficulty most writers of physical descriptions have is that they unconsciously assume their audience can see the subject of the description; in other words, they do not sympathize with the audience's lack of knowledge. You can overcome the difficulty by adhering to a format which organizes the aspects of the description in a way the audience will find reasonable and predictable.

A physical description is sensitive to the problems of an audience which must imagine an object it cannot see. It is careful to direct the reader's attention in a systematic manner. The focus moves left-to-right, and adjoining components are discussed in succession. Perhaps most importantly, the description begins with an overall view of the subject, thus providing the reader a frame of reference in which she may imaginatively arrange the object's parts.

A physical description of a pencil is relatively simple because its parts are symmetrical: there is an obvious long axis about which to work. An object with no straight lines poses greater problems: imagine, for instance, trying to describe the shape of the exterior surface of a Boeing 747. Fortunately, the people who write such descriptions are provided a technical vocabulary which assists them greatly. In the rare case where you do not have such a vocabulary -- or you know that your audience lacks such a vocabulary -- then you have a very real problem. You can overcome it in two ways. First, through the imaginative use of adjectives: "pear-shaped," "sickle-shaped," etc. Second, through the assertion of an arbitrary frame of reference: describe for your audience the dimensions of an imaginary frame, and describe the object within that frame. For instance: "Imagine the object within a box with the dimensions one meter by one meter by two meters, the longest side corresponding to the vertical (y) axis ..." Once the frame has been established, description becomes a relatively simple matter of placing details with reference to it.

When printing budget and time permit, physical descriptions may be greatly assisted by visual aids. A given object may be represented by several views (front and overhead), or by a single view. It may be represented by a line drawing (which outlines an object without shading or detail), a cutaway drawing (which shows the object as though part had been removed) or a cross-section (which shows the object as if it had been sliced in half lengthwise). The choice of visual is determined by the kind of detail necessary. A line drawing, or instance, would be useful only to someone needing to identify the object. Someone needing to understand an internal mechanism would require a cutaway or cross-section.

In general, the visual and the description should complement each other. Names of parts of the object may be listed beside the visual, each name preceded by a number or letter. Corresponding letters or numbers may surround the visual -- lines connecting the letters to the referent part. Letters or numbers should be arranged sequentially, allowing the viewer to find the part easily. Also, a complicated object may require several views. If this is the case, the narrative description should alternate with the visuals: a paragraph of narrative describing a first aspect, the visual of the same aspect, a paragraph of narrative describing a second aspect, the visual of the second aspect, etc.

The modes by which a tool or system are described inevitably focus upon certain aspects of their subject, and omit other aspects. Scientific and technical communicators use these modes to advantage. Physical and functional descriptions are often combined in order to highlight certain aspects of their subject. The scientific and technical communicator should construct such a hybrid not because she is confusing forms, but because she recognizes strengths of each type of description and employs them selectively, always with an eye to what function or what physical detail is necessary to the overall picture.

Although a physical description would be helpful to someone needing to draw the object, it would be nearly useless to someone needing to construct it. For her, another kind of physical description would be in order -- an assembly description.

Assembly Descriptions

A simple assembly description is little more than a listing of parts in the order which they are to be attached to the whole. They may be listed according to the sequence of assembly, or they may be identified merely by serial number. The list may be accompanied by an "exploded" diagram of the object -- that is, a rendering of the object separated in such a way that its parts are arranged along lines radiating from an imaginary central point. A more complicated assembly description -- which would entail the manufacture of some of its parts -- might use terms like "conical" and "beveled," and it might describe components not according to their present arrangement, but by the means in which they were constructed or attached to the whole.

Simple and complex assembly descriptions both include:

The following assembly description is of a Lotus Engineering design for a pursuit racing bicycle which uses aerodynamic principles and composite materials. It is from an article in Popular Mechanics -- written to an mostly unspecialized audience with a general interest in technological developments Lotus used lessons learned from designing Formula One race cars to refine the airfoil shape of the Lotus Sport's monococque -- a 4.5-pound hollow structure that replaces the tube frame. The monococque is a composite of unidirectional and stitched carbon fiber in an epoxy resin matrix, which is molded in two halves.

Comparison Descriptions

Comparison descriptions appear in many contexts. A wildflower identification manual might compare and contrast three very similar plants, a medical textbook might compare and contrast similar symptoms among several diseases. There exists no standard format -- except that the corresponding aspects should be presented in the same order, thus allowing the reader to cross reference easily.

The following comparison description details three solar energy collector technologies. Observe that aspects of each technology are described in parallel form: physical description of the system and its capabilities, history of the system, and potential future applications for the system. Note too how each section selectively combines aspects of functional and physical description.

(from "Focusing on the Future: Solar Thermal Energy Systems Emerge as Competitive Technologies with Major Economic Potential." Golden, CO: Solar Energy Research Institute, 1989.)

Comparisons may be both descriptive and persuasive: an engineering firm's proposal to build a wastewater treatment facility might describe and evaluate three competing design proposals.

Process Descriptions

A process description is a recounting of the stages of any action. It may describe a natural action which occurs without human intervention like the division of a cell or the flow of an electron through a cathode-ray tube. It may also describe a procedure -- corporation's decision regarding a product line, or the manufacture of a microchip.

Description of a Natural Process

A description of a natural process might appear in a scientific article in microbiology, part of a manual for wine makers or, as in this example, a college textbook's explanation of the formation of a main-sequence star as explained in a college astronomy text. A description of a natural process should include:

1 Astronomical Unit: the mean distance from the earth to the sun.

Description of a Procedure

A description of a procedure is directed at someone will require an overall understanding of the process, and who may or may not perform the work. In this sense it differs from a set of instructions. A description of a procedure might be addressed to a plant manager, a group of shareholders, or the reviewer of an application for a process patent. And although (again) a description of a procedure is not a set of instructions, it may introduce a set of directions.

Because a description of a procedure contains steps which are purposeful, it requires a format which attends to purpose. It justifies each step as it explains that step. The following is excerpted from a U.S. Department of the Interior publication entitled Inventory and Monitoring of Wildlife Habitat. Its audience is an administrator who wants to understand the entire process -- and who may manage workers performing it. It includes:

1. an overview of the process

2. a description of the phases listed in the overview in a patterned presentation -- including consistent paragraphing, subheadings and parallel phrasing

The author has dealt with the problem of a diverse audience by first describing a range of situations; then, for the sake of intelligibility and continuity, he focuses on a single example (bighorn sheep) which he follows through the entire process.

3. if appropriate, instructions concerning means to break out of automatic recycling or "closed loops"

4. if appropriate, a list of materials required by the process

The author is careful to define terms like "scoping" as he introduces them.

(from Cooperrider, A. Y., R. J. Boyd, and H.R. Stuart, eds. Inventory and Monitoring of Wildlife Habitat.U.S. Dept. Inter., Bur. Land Manage. Service Center. Denver, Co.)

Composing Descriptions

Use it to make an outline. Then, compose a first draft. Assume that your reader is unfamiliar with the subject, and help your reader by using consistent and predictable patterning. The sections of a functional description of a turbofan engine, for instance, might follow the airstream through the engine; a physical description of a transit might arrange its sections according to parts seen right-to-left; a process description of the manufacture of yogurt might follow the materials through the manufacturing machinery. Compose subsequent drafts with attention to transitions between the sections, making sure you do not "lose" the reader.

You may determine relative formality of the description by two considerations. Consider first the audience's needs. A description of voltage regulator in an electrical supplies catalogue will be brief; emphasis will be placed on what it does. An informal functional description. A description of the same machine in a patent application will be lengthy and detailed; emphasis will be placed upon how it does what it does. A formal functional description. Consider also the audience's technical competence. A technician at NASA's Jet Propulsion Laboratory is likely to understand technical discourse that involves fluid mechanics -- a layperson is not.

Chapter 8: Part 1

Introduction
Definition
Informal Definitions
Formal Definitions
Description
Functional Descriptions
Physical Descriptions
Assembly Descriptions
Comparison Descriptions
Process Descriptions
Description of a Natural Process
Description of a Procedure
Composing Descriptions

Chapter 8: Part 2