Eliminating Sporadic
Noise in Writing: A Style Guide for EE 333T


Problems that crop up intermittently in writing,
often referred to as "faulty mechanics" by English teachers,
might be thought of as sporadic or intermittent noise. It tends to occur
occasionally, rather than affect every page the way a poor choice of type
size or confused organization of material might. Of course enough sporadic
noise in a document, such as repeated misspellings or numerous sentence
fragments, can easily turn into constant noise and give your reader an
impression of hastily and carelessly produced work undeserving of the response
or feedback you want.
To help you eliminate sporadic noise this guide looks at where it
is most likely to occur in spelling, punctuation, sentence structure, and
technical usage. We also give some pointers on how to edit your writing
in order to remove this kind of noise.
SPELLING AND SPELL CHECKERS
You might think the spell checkers that come with most word processing
software have eliminated any need to be a careful speller. Unfortunately
this is not the case. With apologies to Shakespeare we took his words "A
rose by any other name would smell as sweet," and ran them through
a spell checker as A nose by any outer dame wood small as sweat.
No red flags were raised by the program. Nor will spell checkers catch
common errors such as confusing there for their, or to
for too. Some typographical errors simple give you other words which
will pass unnoticed, as in this sentence. A very slight slip of the finger
on the keyboard can make the difference between asking for some forms to
be mailed to you or nailed to you. A quick transposition could render a
memorandum nuclear rather than simply unclear.
At best, the effect of poor spelling on your readers is a sense of annoyance,
or at least of having their attention distracted by something other than
what you want to communicate. At worst, noise created by spelling glitches
can bring readers to a stop and cause them to seriously question your ability
as a writer. They might even suspect that a person who is careless with
spelling could also be inept in more critical technical matters.
To reduce or eliminate any noise in your writing caused by incorrect
spelling, use a spell checker but also have a standard dictionary nearby.
A current dictionary is the only resource that can reliably answer questions
such as
It is especially important for an engineer to use a current dictionary. English is a dynamic language, and the language of science and technology changes even more rapidly as knowledge increases and devices are developed. You won't find words like software, modem, and LED in a dictionary from the 1950s, and since then older words such as bug, hardware, interface, and even mouse have taken on new meanings. Some usage has yet to be decided on: Would a computer shop advertise that it repairs mice or mouses? Do you send e-mail, E-mail, or email? (Right now all three options are used.)
PUNCTUATION
Would you want to drive on a busy highway or in a city where there were
no traffic signs? Controlling the flow of traffic is vital if anyone is
to get anywhere. Similarly, within sentences the flow of meaning is controlled
by punctuation marks, the conventionally agreed-upon "traffic signals"
of written communication. We do the same thing in spoken language by means
of pitch, breath pauses, and emphasis. Directing the flow of ideas in writing
is not really difficult, and a useful procedure when you're unsure of how
to punctuate a sentence might be to say it aloud as in normal conversation.
Pay careful attention to where you pause naturally within the sentence-that
is likely to be where you need some punctuation.
Many detailed guides to punctuation exist, and you may want to look
at them if you have a lot of queries in this area. You will also find excellent
advice on punctuation in the front or back sections of some standard college
dictionaries. Meanwhile, the following suggestions are offered on the most
common problems many engineers tend to have with punctuation.
Commas
Confusion sometimes exists about commas because frequently their use
is optional. Before we arrived at the meeting we had already decided
how to vote would be written with a comma after meeting by some
and not by others. The question to ask is, Does adding or omitting a comma
in a given sentence create noise? In general, if no possible confusion
or strain results, the tendency in technical writing is to omit unessential
commas.
Often, omitting a comma after introductory words or phrases in a sentence
will cause your reader to be momentarily confused-as you would have been
if there were no comma after the first word of this sentence. Here are
further examples of missing commas causing noise:
After the construction workers finished eating rats emerged to look
for the scraps.
In all the containers were in good condition considering the rough journey.
As you can see the efficiency peaks around 10-12%.
If an acoustic horn has a higher throat impedance within a certain frequency range it will act as a filter in that range which is undesirable.
Solution
After the construction workers finished eating, rats emerged to look
for the scraps.
In all, the containers were in good condition considering the rough journey.
As you can see, the efficiency peaks around 10-12%..
If an acoustic horn has a higher throat impedance within a certain
frequency range, it will act as a filter in that range, which is undesirable.
Again, try saying these sentences aloud with their intended meaning.
You'll find you put the comma-or pause-where it belongs almost without
thinking.
One more point about commas: most technical editors prefer what is called
a "serial comma" when you list words or ideas within a sentence,
as in The serial comma has become practically mandatory in most scientific,
technical, and legal writing. You may have been told that the and
joining the last two terms replaces the need for a comma, but this is not
so in technical writing. See how the serial comma is useful in the following
sentences by reading them aloud and noting how you need the pause before
the and:
Fresnel's equations determine the reflectance, transmittance, phase,
and polarization of a light beam at any angle of incidence.
Tomorrow's engineers will have to be able to manage information overload,
communicate skillfully, and employ a computer as an extension of themselves.
A serial comma may also prevent confusion:
Rathjens, Technobuild, Johnson and Turblex build the best turbines
for our purposes.
Unless Johnson and Turblex is the name of one company, you will
need a serial comma:
Rathjens, Technobuild, Johnson, and Turblex build the best turbines for our purposes.
Parentheses are used to set off facts or references in your writing-almost
like a quick interjection in speech:
Resistor R5 introduces feedback in the circuit (see Figure 5).
This reference book (published in 1993) contains up-to-date information.
If what you place within parentheses is not a complete sentence, put
any required comma or period outside the parentheses:
Typical indoor levels of radon average 1.5 picocuries per liter (a
measure of radioactivity per unit volume of air).
Whenever I design a circuit (like this one), I determine the values
of the components in advance.
If your parenthetical material forms a complete sentence, put the period inside the marks:
I have already calculated the values of the resistors. (R1 is 10.5 K_, and R2 is 98 _.) The next step is to choose standard values.
Remember, it is best not to use parenthetical material too frequently
since these marks force your readers to pause, and are likely to distract
them (if only for a brief moment-see what we mean?) from the main intent
of your writing.
Dash
A dash will make a sentence seem more emphatic by calling attention
to the words set aside or after it: He was tall, handsome, rich-and
stupid. Since the dash is considered less formal than the other parenthetical
punctuation marks (parentheses and commas), you should try to avoid it
in very formal writing. If you overuse it, you are in danger of calling
wolf too often, and your dashes will lose their effect. With this caution
in mind, you may still find dashes helpful for the following purposes:
Emphasis:
Staying up all night to finish a lab project is not so terrible-once in a while.
Summary:
Reading all warnings, wearing safety glasses and hardhats, and avoiding
hot materials-all these practices are crucial to sensible workshop procedure.
Insertion:
My opinion-whether you want to hear it or not-is that the drill does
not meet the specifications promised by our supplier.
Notice we are talking about what is called the "em" dash here-the
dash used between words that practically touches the letters at each end
of it. The "en" dash is shorter, more like a hyphen, and used
when you cite ranges of numbers: 31-34; $350-400. Most word processing
programs allow you to choose whichever you need.
Colon
Colons are used to separate the hour and minute in a time notation and
to divide parts of the title of a book or article:
This proposal is due on Monday morning at 8:30 sharp.
One of the books recommended for the seminar is The Limits of
Safety: Organization, Accidents, and Nuclear Weapons.
The most common use of the colon within a sentence, however, is to introduce
an informal list:
For the final exam you will need several items: a pencil, a calculator,
and three sheets of graph paper.
You can also use a colon to introduce an illustration or example, as
we did in the sentence leading into the above example. Note, however, that
in both cases an independent clause-a statement that can stand by itself
and have meaning-comes before the colon. You should not write the
example sentence as
For the final exam you will need: a pencil, a calculator, and three
sheets of graph paper,
because what comes before the colon makes no sense by itself and a colon
needlessly interrupts the flow of the sentence. Instead write
For the final exam you will need a pencil, a calculator, and three sheets of graph paper.
(Note how the same reasoning made us lead into the last two illustrations
with no colon after the words ". . . example sentence as" and
"Instead write. . . .")
Hyphens
Hyphens have been called the most under-used punctuation marks in technical
writing. Omitting them can sometimes create real noise, as when we read
coop (an enclosure for poultry or rabbits) but discover that co-op
was meant. On the other hand, a hyphen sometimes appears where it is unneeded,
as in re-design or sub-question.
Unfortunately, apart from the general rule that hyphens should be used
to divide a word at the end of a line or to join pairs of words acting
as a single descriptor-as in The transistor is a twentieth-century invention-there
is no clear consensus on when to use them. You'll often have to decide
for yourself with the help of a recent dictionary, but here are some suggestions:
We used a 16 key keypad.
We used a 16-key keypad.
We knew Marienet made klystrons would be able to generate a 9.395 GHz microwave.
We knew Marienet-made klystrons would be able to generate a 9.395 GHz
microwave.
The equation assumes a one dimensional plane wave propagation inside the
horn.
The equation assumes a one-dimensional plane-wave propagation inside the
horn.
Research showed the computer aided students improved their grades dramatically.
Research showed the computer-aided students improved their grades
dramatically.
With really complex technical terms you may have very little to go on
regarding hyphens. For instance, how do you punctuate direct axis transient
open circuit time constant? The best solution (direct-axis transient
open-circuit time constant) may only be found in a technical dictionary
or by observing what the common practice is among specialists in the field.
Exclamation Point
The best advice on the exclamation point is to use it all you want in
your novel or letters, but avoid it in professional writing except in the
case of warnings (DANGER: Sodium Cyanide is extremely toxic!). Since
engineering documents seek to convey information, any excitement or triumph
should be generated by the facts provided in the document rather than by
a tagged-on marker. Occasionally an exclamation mark might even be interpreted
by your readers as condescending or sarcastic:
We soon found that the previous data was unsubstantiated!
After reading your report, I feel you might benefit from our on-site
course in technical writing!
Quotation Marks
Use quotation marks to set off direct quotations in your text, and put
any needed period or comma within them, even if the quoted item is only
one word. Although British publishers use different guidelines, the American
practice is to always put commas and periods inside quotes, and semicolons
and colons outside, as in the following:
The manager stressed to the whole group that the key word was "Preparedness."
"The correct answer is 18.2 Joules," he told me.
We had heard about the "Four-Star Marketing Plan," but
no one remembered what it involved.
We left the game right after the band played "The Eyes of Texas";
it was too hot and humid to stay any longer.
If you have to quote material that takes up more than two lines, set
it off from your text by a space and indent it from both right and left
margins. You might even use a slightly smaller font size, and should omit
the quotation marks, as shown here:
Usually, specifications are not written from beginning
to end by a single person. Instead, the lead engineer delegates the writing
of numerous sections to specialists, who may not be aware of the overall
goals of the project, and may have parochial views about certain requirements.
The lead engineer is faced with the difficult task of fitting all these
pieces together, finding all the places where they may conflict, and adjusting
them to be correct and consistent with each other [NAWCTSD Technical Report
93-022, p.11].
Semicolon
Whether we like it or not, the semicolon seems to be disappearing from
much engineering writing. Often it is replaced by a comma, which is an
error according to traditional punctuation rules. More frequently we simply
use a period and start a new sentence, but then a psychological closeness
might be lost. Look at these two examples:
Your program is working well, however mine is a disaster.
Take Professor Hixson's class. You'll find he's a great teacher.
The relationship between these statements could be better stressed by
using a semicolon:
Your program is working well; however, mine is a disaster.
Take Professor Hixson's class; you'll find he's a great teacher.
Perhaps one reason we don't see many semicolons in engineering writing
is that fewer and fewer people feel confident using them. Another possibility
is that little noise results from using a comma or a period and new sentence,
as in the examples above. Note this pair of sentences:
We wanted to finish the computer program yesterday; however, the
network was down all afternoon.
We wanted to finish the computer program yesterday, however, the
network was down all afternoon.
Although the first sentence would be considered correct and the second
wrong, you will find plenty of examples of the second punctuation around.
The main problem in the second sentence is that a reader can't be sure
at first whether however "belongs" to the first half of
the sentence or the second. A semicolon after yesterday is really
needed to make this clear. If you frequently use words like however,
therefore, namely, consequently, and accordingly
to link what could otherwise be two sentences, insert a semicolon before
and a comma after them. You'll find this will add a shade of meaning that
cannot be achieved otherwise.
Use semicolons to separate a series of short statements listed in a
sentence if any one of the statements contains internal punctuation. The
semicolon will then divide the larger elements:
I suggest you choose one social science subject, such as psychology
or philosophy; one natural science course, such as chemistry, physics,
or biology; and one math class.
The team is made up of Seth Deleery, vice-president of marketing;
Mac Hines, director of research; Ruth Ustby, assistant director of training
and human relations; and Leo Little, chief avionics engineer.
SENTENCE SENSE
As engineering writers our aim is to convey information with a minimum of noise. For our purposes the only important "rule" of grammar is to eliminate noise so that the decoder (reader) of the text (message) receives precisely the message the encoder (writer) intends. Thus it's worth looking at those grammatical and stylistic areas where noise often seems to occur in engineering writing. Two persistent but outmoded grammar rules you can safely forget are also discussed in this section under the heading of "Some Latin Legacies."
Connecting Subjects to Verbs
It's unlikely you would write The machines is broken without
quickly noticing a discrepancy between the subject (machines) and
the verb (is). A problem can occur, however, when several words
come between your subject and verb and you forget how you started the sentence.
If you are writing in a hurry and leave no time for editing, you might
produce something like this:
This combination of electrical components constitute a single pole RC filter.
A 35 mm film of some high buildings are strongly recommended.
Only one of the pre-1925 high-rise structures were
damaged in the quake.
Those plural nouns that follow later (components, buildings, structures)
can sometimes mislead us into relating the verb to them rather than to
the earlier nouns (combination, film, one) to which
they belong. This danger increases with the length of a sentence and the
amount of information intervening between the true subject and verb of
a sentence. A good style or grammar program on your word processor may
help prevent this from happening, but it is just as well to be alert to
the danger.
Sometimes a question arises in engineering writing with units of measurement.
Do you write Twelve ounces of adhesive were added or Twelve ounces
of adhesive was added? How about 12 grams of acid was spilled or
12 grams of acid were spilled?
The answer is a matter of logic rather than grammar. Even though we're
alluding to several ounces or grams here, we "see" them as one
unit, and thus the singular verb is preferable. Little or no noise is created,
however, if you slip up on this one.
Using either/or in a sentence occasionally makes us stop and
think. Look at this sentence:
Either the old manual or the recent procedures (is/are?) acceptable.
Which verb should we use? Since a verb is normally controlled by the
noun immediately before it, we would write Either the old manual or
the recent procedures are acceptable. Following this practice
we could also write
Either the recent procedures or the old manual is acceptable.
It is best to follow the same rule with neither/nor. Thus the
following two sentences would be preferred:
Neither the engineers nor their supervisor was invited to
the planning conference.
Neither the rudder nor the wings were badly damaged in the crash.
Modifiers
A modifier is a word or group of words whose function is to add meaning
to other ideas in a sentence. If you say your company has bought a transceiver,
you have certainly conveyed some meaning, but if you say Our company
has bought a TS 840 S transceiver with single sideband capabilities,
you add a lot of meaning to the word transceiver by adding some
modifiers.
The danger lies in creating noise by misplacing the modifiers in a sentence.
Such distortion can produce sentences that don't make sense or that make
sense in the wrong way. Misplaced modifiers occur when a reader gets the
wrong impression (or no impression) of who is doing what in a sentence.
This is frequently because words like "I" or "we "
or "the engineers" or some other subject has been omitted. Consider
the following:
Jumping briskly into the saddle, the horse galloped across the prairie.
After testing the mechanism, the theory was easily understood.
Once having completed needed modifications and adjustments, the equipment
operated correctly and met all specifications.
If we look at these statements logically we have a horse that rides,
a theory that can test a circuit, and equipment that modifies and adjusts.
This is not likely to be what the writer meant. Revising the last two sentences
might result in the following:
Once the team had completed needed modifications and adjustments,
the equipment operated correctly and met all specifications.
After testing the mechanism we easily understood the theory.
Meanwhile, another problem can crop up if you place a modifier too far
from the word or idea it modifies:
I was ordered to get there as soon as possible by fax.
By the age of four her father knew she would be an engineer.
It's not hard to remedy the lack of logic in these sentences and to
avoid traveling by fax or having four year old fathers, but sometimes the
meaning cannot be extracted, as in the following:
The tone-detector circuit was too unreliable to be used in our telephone
answering device, which was built of analog devices.
The sentence is correct if the telephone answering device is made of
analog devices, but much more likely the writer is concerned with the inaccuracies
of an analog tone-detector circuit. This is easily fixed:
The tone-detector circuit, which was built of analog devices, was
too unreliable to be used in our telephone answering device.
Parallelism
Parallelism refers to the need for items in a list to share the same
grammatical structure. Faulty parallelism creates noise because it violates
a sense of logical consistency. Rather than tell someone you like to
jog, wrestling, and play the fiddle, you would probably say you
like to jog, wrestle, and play the fiddle, or that you enjoy
jogging, wrestling, and playing the fiddle. But in longer
sentences there is a danger of losing control of this logic.
After a lot of discussion the team concluded that their alternatives
were to call in a consultant, thus increasing the cost of the project,
or having three more engineers reassigned to the team.
Note how this sentence reads as if the team's alternatives are (1) to
call in a consultant, and (2) having more engineers reassigned-two unparallel
statements that can grate on our sense of logical flow. The sentence can
be rewritten to state that the alternatives were to call in a consultant....or
to have three more engineers reassigned. See if you can recognize the
lack of parallelism in this sentence:
The back-up system should be efficient, should meet safety specifications,
and have complete reliability.
To make this statement parallel, think of the list embedded in it. We are told that the back-up system
1. should be efficient
2. should meet safety specs
3. have complete reliability.
To be consistent, the sentence needs one more should-or one less:
The back-up system should be efficient, should meet safety specifications,
and should be completely reliable.
The back-up system should be efficient, meet safety specifications,
and be completely reliable.
This might seem like a rather fine point, but since a lack of parallelism
can often cause a reader to pause, if only subconsciously, it qualifies
as noise when it occurs in a sentence.
Fragments
Sentence fragments are partial statements that create noise because
they convey an incomplete unit of information. Here is an example:
She decided to major in petroleum engineering. Even though it would
take five years.
The first sentence makes sense by itself; try saying the second statement alone, as an independent exclamation, and your listeners would be lost. We must admit, however, that in everyday speech and popular journalism you will find plenty of fragments which seem to cause little or no noise. Look at this example:
Nearly 60 percent of U.S. households had VCRs by the end of the 1980s.
In spite of the microwave oven being the most popular appliance of the
decade.
We know what the writer means here, but strictly speaking the second
statement is a fragment because it could not stand alone and make sense.
The words In spite of indicate a contrastive relationship that is
clear only in the context of the first statement. It would be more efficient
to write
In spite of the microwave oven being the most popular appliance of
the 1980s, nearly 60 percent of U. S. households had VCRs by the end of
the decade.
In your formal engineering writing you would do well to avoid incomplete
sentences. They can usually be quite easily remedied, as you can see. Here's
another example:
Fragment:
Delays in the October shipments have occurred. Due to the strike.
Complete:
Delays in the October shipments have occurred due to the strike.
Better:
The October 6 shipments have been delayed by the strike.
or
The strike has delayed the October 6 shipments.
Active or Passive Voice?
As indicated in the last pair of sentences above, we can use two distinct
'voices' in English sentences. The active voice directly states that someone
does something, as in The engineer wrote the report. The passive
voice turns it around to The report was written by the engineer.
Thus the active voice emphasizes the performer of the action-the engineer,
in our example-while the passive emphasizes the recipient of the action,
the report.
Many engineering and scientific writers in the past have been advised
to leave themselves out of their writing. They might write It was ascertained
that. . . long before they would admit We made sure that. . .
. Chances are management would rather tell you It has been decided to
terminate your employment than We have decided to fire you. Perhaps
such hedging is necessary at times (it helps conceal responsibility), and
there is something to be said for "scientific objectivity," but
the natural form of the English sentence is the active voice. This form
is also the more efficient one. Look at the following pairs:
Control of the flow is provided by a DJ-12 valve.
A DJ-12 valve controls the flow.
A system for delineating these factors is shown in Figure 5.
Figure 5 shows a system for delineating these factors.
By switching off the motor when it started to vibrate and looking at the tachometer, the resonant frequency was determined.
We determined the resonant frequency by switching off the motor when it started to vibrate and looking at the tachometer.
The use of the passive becomes especially burdensome in procedures or
instructions:
The button is pressed twice.
vs.
Press the button twice.
Previously entered data in the DataBase is eliminated by the Edit menu being opened and Select All being chosen.
vs.
Eliminate previously entered data in the DataBase by opening the Edit
menu and choosing Select All.
Fortunately modern engineering writers are getting away from the rigid
use of the passive as they realize there is nothing dreadful about using
the active voice. Sentences become more vigorous, direct, and efficient
in the active form, and by showing that a person is involved in
the work, you are doing no more than admitting reality. Also, the active
voice gives credit where credit is due. If we read in a progress report
that several references were checked out from the library and 25 pages
of notes were taken, are we as impressed by the energy expended as
when we read I checked out several books from the library and took 25
pages of notes?
One danger of avoiding the active voice is that we can end up writing
some pretty absurd things:
Hurrying to complete the project, several wires got soldered together
incorrectly.
The supervisor was seen by us, and we were ignored by her.
Not every use of the passive is inadvisable, of course. Sometimes it
will give variety to your writing, and passive verbs can always be used
if the doer of an action is unknown or unimportant, or if what is being
done is simply more important than the doer:
Electricity was discovered thousands of years ago.
The bridge was torn down in 1992.
The contaminated material is then taken to a safe environment.
Perhaps the best policy is to use the active voice in your writing if it seems the most natural and efficient way to express yourself, assuming there is no company policy against its use (there is in some companies).
Sexist Language
Gender, or sex, is now only indicated in English by she /he,
his /hers, her /him, and by a small group of
words describing activities formerly pursued by one sex or the other, such
as mailman, stewardess, chairman, or seamstress. Now of course
men might bring the drinks on an airplane and women might deliver the mail,
not to mention take an equal place in the engineering workplace. Because
of this it is unnecessarily restrictive-and to some people offensive-to
use gender-specific terms in writing and speech unless there is good reason
to do so. The following pairs show how easy it is to reword your sentences
or paragraphs to include everyone they should:
Restrictive:
Every engineer should be at his workstation by 9 a.m.
Inclusive:
Every engineer should be at his or her workstation by 9 a.m.
or (preferred because less wordy):
Engineers should be at their workstations by 9 a.m.
Restrictive:
An employee can expect a lot of challenges during his career here.
Inclusive:
Employees can expect a lot of challenges during their careers here.
Restrictive:
Every technician must wear safety glasses when he enters the work area.
Inclusive:
Technicians must wear safety glasses when entering the work area.
Most nouns indicating gender in English have already been modified to
be inclusive. A recent dictionary can guide you here. One title that still
sneaks through, however, especially in organizations traditionally dominated
by males, is chairman. If the "chairman" is female, is
she the chairwoman or chairperson? Both are acceptable, but it's probably
simpler to refer to anyone in such a position as chair:
Sarah is chair of the new committee on marketing strategy.
or
Sarah is chairing the new committee on marketing strategy.
Some Latin Legacies
A few grammar rules impressed upon us in the past really do not hold
up under careful linguistic or logical inspection. They were based on how
Latin works, rather than English. To put it another way, noise rarely occurs
when these rules are ignored. Here are the two main ones, together with
comments and a caution.
1. "Never End a Sentence with a Preposition. "
In reality a preposition is often the best word to end a sentence with.
(A purist might claim we should have just written . . . the best word
with which to end a sentence ). When an editor criticized Sir Winston
Churchill for doing so, Churchill responded with "Young man, this
is the kind of nonsense up with which I will not put!" After all,
did you find any noise in the opening sentence of this paragraph? Efficient
writing sometimes dictates that we end a sentence with a preposition. Compare
the following pairs. You can see that in each case the first sample, ending
with a preposition, flows better and is more natural:
That's a problem that we will really have to work on.
That's a problem on which we will really have to work.
We must make sure we can find some engineering consultants we can really count on.
We must make sure we can find some engineering consultants on whom
we can really count.
2. "Never Split an Infinitive. "
An infinitive is the form of a verb that combines with the word to,
as in to go, to work, or to think. Confident writers
have dared to deliberately split the infinitive whenever doing so
was in the best interests of clear writing. Certain TV space adventurers
have been daring to boldly go where the rest of us can't for a long
time now, and an electrician may find it necessary (and safer) to entirely
separate the wires in a power line sometimes. But don't overload a
split infinitive. If you put too much material between your to and
the rest of the verb, noise or even nonsense might result:
The team has been unable to, except for the lead engineer and one
technician who is on temporary assignment with us, master the new program.
Rewrite this as
Except for the lead engineer and one technician on temporary assignment with us, the team has been unable to master the new program.
or
The team has been unable to master the new program-with the exception
of the lead engineer and one technician who is on temporary assignment
with us.
Transitions
Transitional words and phrases are signposts that show a reader the
way your thinking is going. They help connect ideas, distinguish conditions
or exceptions, or point out new directions of thought. Simple words like
therefore, thus, similarly, and unfortunately
eliminate ambiguity by helping a reader interpret your information. So
if you neglect transitions in your writing you create noise, since your
reader might miss some important connection. Look at these two sentences:
The group's long-range plans for the S-34B project have been extended.
The completion date for the project is as originally planned.
Both sentences are grammatically correct and contain important facts,
but can the reader tell how these facts are related? Now notice how the
next three illustrations indicate relationships the first example does
not:
The group's long-range plans for the S-34B project have been extended.
Nevertheless, the completion date for the project is as originally planned.
The group's long-range plans for the S-34B project have been extended.
Unfortunately, the completion date for the project is as originally planned.
Even though the group's long-range plans for the S-34B project have
been extended, the completion date for the project is as originally planned.
While facts are important, it is often the relationships between the
facts that create the whole picture. Thus you should make your transitions
and connections as strong as possible. Here are some examples:
To indicate a sequence: before...later, first...second, in addition, additionally, then, next, finally
Before the project got under way we felt we could never meet the deadline. Later, it became clear there was a realistic chance of doing so.
To indicate contrast: but, however, yet, still, nevertheless, although, on the contrary, in contrast, on the other hand
The GX-40 vehicle scored over 96% in initial dependability testing; nevertheless, the design was scrapped.
To indicate cause and effect: consequently, therefore, so, thus, hence
This company has had to downsize lately. Consequently, many of our staff are looking for other positions.
To indicate elaboration: further, furthermore, for example, moreover in fact, indeed, certainly, besides
The automotive airbag has proved to be a major factor in driver survival.
Moreover, the bag has generated considerable profits for its producers.
Sentence Length
When dealing with highly technical subjects you should rarely write
sentences over twenty words long. Technical material can be difficult enough
to follow without being presented in long, complex sentences, particularly
if your audience is less familiar with your field than you are. Even nontechnical
ideas are hard to grasp in an unnecessarily longwinded sentence:
We finally had a long discussion with the R & D staff but were
not able to convince them that they should commit to a specific date for
implementation of the design, but instead they responded with a proposal
to extend the project, which would result in a lot more work for all of
us and a considerable loss of profits for the company.
Nobody wants to be left breathless at the end of a mile-long sentence. If you find your sentences tend to be lengthy, look for ways to break them into two or more separate ones. The readability of your prose will be determined partly by the length of your sentences. On the other hand, too many short sentences may leave your readers feeling like first graders:
The Kw766XTR is a low-profile desktop scanner. It has outstanding performance. It offers a frequency range of 29-54 and 108-174 MHz. It includes 50 memory channels. The design is sleek. Individual channels can be locked out. They can also be delayed.
Try to vary your style and avoid both lengthy and abrupt sentences.
Remember, however, that very short sentences, used sparingly, can be effective
in helping you reinforce a point.
TECHNICAL USAGE
Useless Jargon
In its negative sense, jargon is pure noise since it refers to unintelligible
speech or writing. The word derives from a French verb meaning the twittering
of birds, and has a lot in common with "gobbledygook," first
used to compare the speech of Washington politicians to the gobbling of
Texas turkeys. High-tech jargon is sometimes known as techno-babble. Some
people seem to like to sprinkle their writing liberally with such impressive-sounding
phrases as integrated logistical programming, differential heterodyne
emission, or functional cognitive parameters. Unfortunately,
unless these words mean something to both writer and reader, no communication
takes place.
Techno-babble is so common that we have created an "electrotechnophrase generator" to help addicts satisfy their habit. Select any three-digit number and read off the corresponding words from the chart below; for example we used 2-8-3 to get differential heterodyne emission. Readers may have no idea of what you mean, but they should be impressed-or afraid to ask for a meaning.
Column 1 Column 2 Column 3
0. voltaic integrated simulation
1. Sholokhov's semiconductor algorithm
2. differential Yagi attenuator
3. Fourier scaled emission
4. transient Q-factor diode
5. virtual tracking parameters
6. phasor diffusion network
7. compound Doppler gate
8. thermal heterodyne transducer
9. Gaussian coaxial magnetron
How To Sound Like A Real Technocrat
Useful Jargon
In another sense, however, jargon is the necessary technical terminology
used in specialized fields. A chemist might use the term deoxyribose
around a group of peers without feeling a need to explain it, just as a
geologist could talk about the Paleozoic era or Devonian period with other
geologists. Computer engineers can safely refer to bytes, bauds, and packet
switching-among themselves. Communication between experts would be ponderous
if not impossible if they had no specialized jargon. Moreover, each year
technical language increases greatly as scientific knowledge increases;
thousands of technical terms used today were unknown just a few years ago.
Sometimes you will find that common words take on new meanings when
used by experts. Charge, conductor, mole, and mouse are just
four examples. Printers (the people, not the machines) mean something quite
different than most of us would when they refer to widows and leading.
As engineers you know and use all sorts of technical jargon. Some you share
with most engineers, some with those in the same general field of engineering
as you-such as chemical, civil, or aerospace-and some you would use only
among peers in highly specialized fields like celestial mechanics or software
engineering.
There is only one way to avoid noise when using technical terminology:
know your audience. Make certain you are writing or speaking at
their level of comprehension, because if you're above their heads you will
be wasting your time and theirs. Explain terms whenever necessary; don't
risk confusing readers or losing them completely because they don't know
what you are talking about. Definitions within your text, examples, analogies,
or a good glossary are all useful tools for the technical writer who must
frequently communicate with less technically inclined audiences.
Abbreviations
Abbreviations are necessary in technical communication for the same
reason valid technical jargon is: they refer to concepts that would take
a great deal of time to spell out fully. It would be time-consuming and
boring for a computer expert to read Computer-Aided Design/Computer-Aided
Manufacturing several times (or hear it in a talk) when CAD/CAM
would do. However, you will create a lot of noise in your writing if you
use abbreviations your readers don't understand. Always spell abbreviations
out the first time you use them unless you know this would insult the intelligence
of your audience:
Then it goes into the ROM (Read-Only Memory).
To understand our billing process, you first need to know what a British Thermal Unit (BTU) is.
Once you have defined an abbreviation you can normally expect your reader to remember it. The exception to this would be if you are using some highly complicated or unusual abbreviations throughout your document, in which case you may need to remind readers more than once what the abbreviations stand for, or provide a glossary they can refer to.
Initialisms and acronyms
Abbreviations can be subdivided into initialisms and acronyms.
Initialisms (sometimes called initializations) are formed by taking the
first letters from each word of an expression and pronouncing them as initials:
GPA, IBM, LED, UHF. Acronyms are also created from the first letters
or sounds of several words, but are pronounced as words: AIDS, FORTRAN,
NAFTA, NASA, RAM, ROM. Some acronyms become so well-known that they
are thought of as ordinary words and written in lower case: bit, laser,
pixel, radar, scuba, sonar.
Don't be surprised if you find a list of both initialisms and acronyms
lumped under the title ACRONYMS. Many engineering writers no longer
observe the distinction between the two, and call any abbreviation an acronym.
You probably shouldn't make an issue of it, especially if the writer is
your superior.
Two usage pointers:
1. Use the correct form of a/an before an initialism. No matter
what the first letter is, if it is pronounced with an initial vowel sound
(for example the letter M is pronounced "em") write an
before it:
an MTCR (Missile Technology Control Regime)
an LED readout
an SRU pin
an ultrasonic frequency (but a UHF receiver )
Some abbreviations might fool you. Consider LEM (lunar excursion module)
for example. If the custom is to pronounce it as an initialism, L-E-M,
then you will have an LEM. If it is normally considered an
acronym (as one word), you will have a LEM.
2. Form the plural of acronyms and initializations by adding a lower-case s. Only put an apostrophe between the abbreviation and the s if you are indicating a possessive form:
We ordered three CRTs.
We were not satisfied with the last CD-ROM's performance.
or
We were not satisfied with the performance on the last CD-ROM.
Numbers
Engineering means working with numbers a great deal. Frequently this
is where a lot of written noise occurs due to typos, incorrect or inexact
numbers, and inconsistencies. Obviously you can avoid serious noise by
making certain any number you write is accurate. You should also give numbers
to the necessary degree of precision: know whether 54.18543 is needed in
your report or whether 54.2 will do. Avoid noise from inconsistent use
of numbers by following these guidelines:
1. Numbers can be expressed as words (twelve) or numerals (12). Cardinal
numbers are one, two, three, etc. Ordinal numbers are first,
second, third, etc. Although custom varies, it's a good idea to write
the cardinal numbers from one to ten as words and all other numbers as
figures.
two transistors 232 stainless steel bolts
three linear actuators 12 capacitors
However, when more than one number appears in a sentence, write them all the same:
The IPET has 4000 members and 134 chapters in 6 regions.
Also, use numerals rather than words when citing time, money, or measurements:
1 a.m. $5.48 12.4 m 18 ft
2. Spell out ordinal numbers only if they are single words. Write the
rest as numerals plus the last two letters of the ordinal:
second harmonic 21st element
fourteenth attempt 73rd cycle
3. If a number begins a sentence, it's a good idea to spell it out regardless
of any other rule.
Thirty-two computers were manufactured today.
To avoid writing out a large number at the beginning of a sentence,
rewrite the sentence so it doesn't begin with a number:
Last year, 5198 computers were manufactured in this division.
NOTE: You may sometimes see very large numbers written with spaces
where you usually put commas. Thus 10,354,978 might appear as 10 354 978.
This is to avoid any possible confusion with the practice in some countries
of using commas as decimal markers. Decide which method you want to use
based on your company's preference and/or your audience.
4. Form the plural of a numeral by adding an s, with no apostrophe:
80s 1920s
Make a written number plural by adding s, es, or by dropping
the y and adding ies:
nines sixes
fours nineties
5. Place a zero before the decimal point for numbers less than one.
Omit all trailing zeros unless they are needed to indicate precision.
0.345 cm 12.00 ft
0.5 A 19.40 tons
6. Write fractions as numerals when they are joined by a whole number. Connect the whole number and the fraction by a hyphen:
2-1/2 liters 32-2/3 km
7. Time can be written out when not followed by a.m. or p.m., but you will normally need to be more precise than this. Use numerals to express time in hours and minutes when followed by a.m. and p.m. or when recording data. Universal Time (UTC, from the French for universal coordinated time) uses the 24-hour clock.
ten o'clock 10:41 a.m. 8:45 p.m.
4 hours 36 minutes 12 seconds 23:41 (= 11:41 p.m.)
8. When expressing very large or small numbers, use scientific notation. Some numbers are easily read when expressed in either standard or scientific form. Choose the best format and be consistent:
0.0538 m or 5.38 x 10-2 m
8.32 x 10-21 m/s but 367 345 199 m/s
Units of Measurement
Although the public in the United States is still not committed to the
metric system, you will find that in general the engineering profession
is. Two versions of the metric system exist, but the more modern one, the
SI (from French Système International), is preferred. The vital
rule is to be consistent. Don't mix English and metric units unless you
are forced to. Be sure to use the commonly accepted abbreviation or symbol
for a unit if you do not write out the complete word, and leave a space
between the numeral and the unit.
70 ns 100 dB 12
V 34.62 m 23
e/cm3 6 Wb/m2
Many people, including technically trained ones, still think in standard or English units of measurement, so sometimes you may find it advisable to give both referents in your writing. As with many other editorial matters, you can only make this decision after thinking of your readers' needs. When it might be advisable to add "explanatory" units, as with a mixed audience, do so by writing them in parentheses after the primary units:
212 oF (100 oC)
5.08 cm (2 in)
Make sure you use the correct symbol when referring to units of measurement,
and remember that sometimes similar symbols can stand for more than one
thing. A great deal of noise would result if you confused the following,
for example:
oC (degrees Celsius)
C (coulomb-unit of electric charge)
g (gram)
G (gauss- measure of magnetic induction)
m (thousandth)
M (million)
s (second-as in time)
S (siemens-unit of conductance)
G (gauss)
G (gravity)
G (giga-)
Units of measurement derived from a person's name usually are not capitalized,
even if the abbreviation for the unit is. Note also that although the name
can take a plural form, an s is not added to the abbreviation to
make it plural:
amperes A farads F henrys H
kelvins K newtons N volts V webers Wb
When working with very large or very small units of measurement you
will need to be familiar with the designated SI expressions and prefixes:
Factor Prefix Symbol
1018 exa- E
1015 peta- P
1012 tera- T
109 giga- G
106 mega- M
103 kilo- k
102 hecto- h
101 deka- da
10-1 deci- d
10-2 centi- c
10-3 milli- m
10-6 micro- m
10-9 nano- n
10-12 pico- p
10-15 femto- f
10-18 atto- a
A recent dictionary of scientific terms will guide you if you are unsure of the correct spellings or symbols of the units you are using. There is no point in using them in your writing, however, if you or your audience don't know what they mean. Symbols and abbreviations are indispensable to an engineer, but use them sparingly when writing for an audience other than your peers. You may sometimes need to define the ones you use, either in your text parenthetically (a brief explanation in parentheses following the term or symbol, like this) or with annotations:
P = I E (1)
where
P = power, measured in watts
E = EMF (electromotive force) in volts
I = current in amperes
Equations
It would be hard to do much engineering without equations. They communicate
ideas far more efficiently than words at times-consider the ideas represented
by E = mc2 for example. However, formulas and equations
slow down your reader, so use them only when necessary and when certain
your audience can follow them.
Many word-processing programs now make it easy to write equations in
text, but if you have to write them in longhand do so with care to ensure
both accuracy and legibility. An illegible or ambiguous equation is hardly
going to communicate data effectively, and an error in an equation could
be disastrous. In other words, make sure your equations are noise-free.
You should normally center equations on your page and number them sequentially in parentheses to the right for reference. Leave a space between your text and any equation, and between lines of equations. Also, space on both sides of operators such as =, +, or -. If you have more than one equation in your document, try to keep the equal signs and reference numbers parallel throughout:
F(x) = _logx dx (1)
H(s) (xv2) = X(s)/Y(s) (2)
Eventually you may have to incorporate multiline equations into your technical papers and reports, where they will read (and should be punctuated) just like sentences.
EDIT, EDIT, EDIT
If you look at the early handwritten drafts of some of the greatest writers' works you'll see alterations, additions, deletions, and other squiggles that indicate how much revision went into the draft before it became a finished work. We could all produce better written documents if we always
1. had the time to edit our work carefully
2. took the trouble to edit our work carefully
For an engineer, time is frequently going to be a problem. You can't
always find time for a leisurely edit of your work. However, you would
still be ill-advised to send a first draft of anything of importance to
your readers. A quick e-mail note to a friend about lunch isn't worth much
concern, but anything more than this, especially if it's going beyond your
immediate colleagues, needs at least to be looked over briefly with an
editorial eye. How much time you invest in editing should be in direct
proportion to the importance of the document. Use all the assistance your
word processor will give you, including any spelling, grammar, or readability
programs you may have, but don't follow their suggestions blindly. You
have to be the final arbiter on the clarity and effectiveness of your
work-your name will be on the document, not your word processor's
manufacturer.
Editing At Different Levels
Rather than read over their finished document once or twice in hopes
of randomly finding anything in need of improvement, many writers like
to take a more methodical approach to editing. You might want to try this.
First, check your document for TECHNICAL ACCURACY. Then decide what "writing
levels" to approach your editing on, and go through your document
at least once on each level. Level 1 might be the highest level of the
document, where you check the overall format, organization, and appearance.
Is the work arranged the way it should be? Are specifications (if any)
followed? Is it the right length? Have you used the best font size, margins,
and spacing? Are headings, subheadings, lists, and graphics used effectively?
Level 2 will involve looking at such things as paragraph and sentence
length and structure, possible verbiage, and precise word choice. Is the
tone of your document appropriate? Have you used the active voice where
possible? How about transitions, parallelism, and emphasis where called
for?
The final level, Level 3, is the nitty-gritty one of mechanics, spelling,
punctuation-all the basics we were supposed to master in elementary and
high school. As mentioned above, a good word processing program will provide
you with suggestions on spelling and grammar; however, you must
make the final choices on many of these options.
Collaborative Editing
There is nothing wrong with having a colleague, friend, or spouse look
over your writing before you submit it to its intended audience. Two heads
are usually better than one for discovering flaws in a piece of writing,
and you are no longer in a freshman English class where such help might
be considered plagiarism. In industry, experts often cooperate in writing
technical reports, proposals, and other documents. Most lengthy documents
are produced by team effort, where different team members use their particular
strengths to ensure that the document is the best it possibly can be.
Collaborative editing, then, can involve something as simple as asking
a friend for his or her opinion of the organization, clarity, and mechanics
of your work, and using those comments to improve your writing where necessary.
The more skilled and frank your friend is, the better. With a long document,
however, collaborative editing can be done by having different team members
check the document at different levels, which is usually better than having
everyone searching for whatever they can find at all three levels at once.
BIBLIOGRAPHY
The Chicago Manual of Style, 14th ed. Chicago: The University
of Chicago Press, 1993.
Masse, Roger E. "Theory and Practice of Editing Processes in Technical
Communication," IEEE Transactions on Professional Communication,
vol. PC-28, no. 1, pp. 34-42, March 1985.
Nadziejka, David E. "The Levels of Editing Are Upside Down,"
Proceedings of the International Professional Communication Conference,
pp. 89-93, Sept 28-Oct 1, 1994.
Rubens, Philip, ed. Science and Technical Writing: A Manual of Style.
New York: Henry Holt and Company, Inc., 1992.
Weiss, Edmond H. The Writing System for Engineers and Scientists.
Englewood Cliffs, NJ: Prentice-Hall, Inc., 1982.
