Basic Techniques in Technical Writing
Basic Techniques in Technical Writing
Basic Techniques in Technical Writing
DEFINITION
Informal definition
- comes in a word or a phrase oftentimes called a synonym.
Examples:
1. Lieu - place
2. Embellish or Adorn - decorate
3. Novice - rookie
4. Clever - smart or intelligent
5. Amenable - agreeable
6. Counterfeit - fake
7. Apothecary - pharmacist
8. Circumvent - avoid
9. Eccentric - abnormal
10 Partisan - biased
Examples:
1. Entomology is the branch of science that is concerned with the study of insects
2. Ichthyology is the branch of science that deals with the study of fishes
3. An isocracy is a form of government where all citizens have equal political power
4. A monarchy is a form of government in which the office of head of state is a King or a Queen and is usually hereditary or, in some
cases, elected and which includes a royal house
5. Joule is the SI derived unit used to measure energy or work (SI-International System)
6. Kelvin is the SI derived unit used to measure temperature (SI - International System)
7. Amnesia is a condition in which memory is disturbed or lost
8. Dementia a condition that is a serious loss of cognitive ability in a previously unimpaired person, beyond what might be expected
from normal aging
9. Coquina is a sedimentary rock formed by accumulation of abundant shell fossils and fragments
10. Lignite is a sedimentary rock composed of organic material
Examples:
1. Gas is one of the three states of matter who fills its container regardless of the shape. ( basic principle )
2. Economics comes from the Greek word oikonomia which means ,management of a household.( Etymology )
3. Metamorphic rock is a type of rock that was once one form of rock but has changed to another under the influence of heat,
pressure, or some other agent without passing through a liquid phase. ( physical description )
4. Smoke is the visible vapor and gases given off by a burning or smoldering substance, especially the gray, brown, or blackish
mixture of gases and suspended carbon particles resulting from the combustion of wood, peat, coal, or other organic matter.
(physical description )
5. Recycle is to treat or process (used or waste materials) so as to make suitable for reuse: example is a pillow made of pieces
plastics. (exemplification)
Definition
1. Formal Definition
-(is preferred because of the need for more precision in its wording.)
Three part of Formal Definition: term, genus, and differentia.
a. Term
2. Informal Definition
The need for defining occurs when the report uses technical terms which are not familiar to the reader.
b. Genus
is the group or class to which the term belong.
c. Differentia
is the part of the formal definition which states the distinctive characteristics of the term distinguishing it from other
members of the same class.
Rule No.3. In defining a term, avoid using the term itself or any of its derivatives.
1. Details
A term can be clarified by the addition of related or supporting particulars. To define a mechanism, a vivid
description of its various parts will enable the reader to see it.
2. Examples or instances
General statements particularly abstract definitions are made more concrete when illustrations are cited.
3. Comparison, Contrast and Analogy
Analogy cites similarities. The reader is made to understand an unfamiliar object or idea by comparing it with
another object or idea more familiar to the reader. Using contrast, the differences of both objects are cited in order
to make the idea clear. Comparison combines the two methods by pointing out similarities and differences.
4. Word derivative
Extended definitions may be revealing and interesting because they explain the origin of the term or the idea.
Definitions such as these are seldom logically adequate, but they are often extremely useful illustrations for
clarification.
Placement of Definition in Reports
Definitions may be placed:
1. In the text itself
when the terms to be defined are not many and synonyms or appositives will suffice to make their meanings
clear;
2. In the footnote
when the report is to be read by a mixed group of readers, some of whom may know the terms used in the text;
3. In a special section in the introduction
when the terms are of critical importance in understanding the text of the report; and
4. In the glossary at the end of the report
when the inclusion of too many definitions in the itself would cause repeated interruptions, thereby causing the
reader to lose track of the topic being discussed.
1.Definition
In technology, words have precise, specific meanings; therefore there is a need for defining a technical
term clearly. The extent to which a term should be defined or the length of a definition depends on the
writer's purpose and the knowledge level of the reader.
Before going to the problem of "how to define", it is better to "think about what should be defined
first." It is not possible of course, to set up an absolute list of terms and ideas that would require
definition, not even for a specific body of readers, but it is possible and desirable to clarify the point of
view from which the problem of definition should be attacked.
The relationships of words to the ideas and things for which they stand can become very complex.
However, there is a simple and helpful way of classifying words, as they will appear to your reader. The
words will fall into one of the following categories:
1. Familiar words for familiar things
2. Familiar words for unfamiliar things
3. Unfamiliar words for familiar things
4. Unfamiliar words for unfamiliar things
2.Description of a Mechanism
A mechanism is generally defined as any object or system that has a working part or parts. Most often
the term suggests tools, instruments, and machines. But other examples of mechanisms could be the
human body and systems like the universe or a city, which is composed of parts that work together like
parts of a machine. A technical man constantly works with mechanisms and always needs to
understand them; what they do, what they look like, what parts they have, and how these parts work
together.
There are three fundamental divisions of the description and these are the introduction, the part-by-
part description, and the conclusion.
Because the description of a mechanism seldom constitutes an article or report by itself, the
introduction required is usually rather simple. The two elements that need most careful attention are:
1. the initial presentation of the mechanism
2. the organization of the description
3.Description of a Process
A process is a series of actions, and fundamentally the description of a process is the description of
action. The action may be either one of two types. One type is that in which attention is focused on the
performance of a human being, or possibly a group of human beings. A simple example is filing a
workpiece by hand; in a description of this process, emphasis would fall naturally upon the human
skills required. The other type involves action in which a human operator either is not directly
concerned at all, or inconspicuous. An instance is the functioning of a contactor.
In describing almost any process, regardless of types there are problems that usually arises and these
are:
1. adaptation of the description to the reader
2. overall organization
3. use of illustrations
The five basic principles of good technical writing could be taken as the foundation on which further
development of the skills in writing should be developed. Comments by different authors of technical
writing books refer to these principles as so important that in fact it should comprise the basics of
technical writing. However, these principles are so basic and important that it encompasses the whole
development of the subject, technical writing.
1. Always have in mind a specific reader, real or imaginary, when you are writing a report; and always
assume that this reader is intelligent, but uninformed.
2. Before you start to write, always decide what the exact purpose of your report is; and make sure
that every paragraph, every sentence, every word, makes a clear contribution to that purpose, and
makes it at the right time.
3. Use language that is simple, concrete, and familiar.
4. At the beginning and end of every section of your report check your writing according to this
principle: First you tell your readers what you are going to tell them, then you tell them, and then you
tell them what you have told them."
5. Make your report attractive to look at.
Mechanism Descriptionexplains the arrangement and shape of an object in space. Such a description
may involve movement, complex motions are better handled with the process description. Typically,
the parts of mechanism description answer the following questions in order:
What is it?
What is its function?
What does it look like?
How does it work?
What are its principal parts?
Give a detailed description of each part.
Each of these parts may require a mechanism description of its own.
Process Descriptionexplains the arrangement of a sequence in chronological order. In organization, it is
similar to mechanism description, except that the "part-by-part" becomes step by step:
What is it?
What is its function?
Where and when does it take place?
Who or what performs it?
How does it work?
What are its principal steps? [2]
Process description includes sequence, instructions and procedure; however, only instruct if you expect
your reader to perform the process you describe. Try to keep separate these two concepts: "How to do
something" and "How something occurs" The first calls for instructions or procedure; the second, for
sequence.
Classificationinvolves grouping things together (on the basis of similarities) and dividing them
(according to differences). Classification assists in the complete consideration of a topic .Note the
danger of Faulty Coordination.
Partitionis the act of dividing things into their component parts; very similar to classification, and an
inevitable part of mechanism description and process description .Partition could be spatial (how each
part looks) or functional (how each part works).
Definitionuses words to fix the meaning of a thing -- to make it "definite". The short definition (a
paragraph or a single sentence) is essential to technical writing. For instance, the Mechanism
Description and the Process Description each begin with a call for a definition. A definition answers the
question "what is it?" Good definitions employ the following formula:
species = genus + differentia thing to be defined = group to whichthe thing belongs + specific details
that separate itfrom other things in its group A batten is a tapered piece of wood that fits into a pocket
in the trailing edgeof a sail, helping it hold the shapethat allows it to propel a boat.
Sometimes definitions might be much longer than one sentence, in which case you are still trying to
answer "what is it?" but will be using most other patterns to help answer it: you can define by
describing, classifying, comparing, etc.
Posted by ervin at 8:32 PM 0 comments
Definition
uses words to fix the meaning of a thing -- to make it "definite". The short definition (a paragraph or a
single sentence) is essential to technical writing. For instance, the Mechanism Description and the
Process Description each begin with a call for a definition. A definition answers the question "what is
it?" Good definitions employ the following formula:
species = genus + differentia thing to be defined = group to whichthe thing belongs + specific details
that separate itfrom other things in its group A batten is a tapered piece of wood that fits into a pocket
in the trailing edgeof a sail, helping it hold the shapethat allows it to propel a boat.
Sometimes definitions might be much longer than one sentence, in which case you are still trying to
answer "what is it?" but will be using most other patterns to help answer it: you can define by
describing, classifying, comparing, etc.
Posted by ervin at 8:32 PM 0 comments
Partition
is the act of dividing things into their component parts; very similar to classification, and an inevitable
part of mechanism description and process description .Partition could be spatial (how each part looks)
or functional (how each part works).
Posted by ervin at 8:30 PM 0 comments
Classification
involves grouping things together (on the basis of similarities) and dividing them (according to
differences). Classification assists in the complete consideration of a topic .Note the danger of Faulty
Coordination.
Posted by ervin at 8:30 PM 0 comments
DESCRIPTION OF MECHANISM