Chapter 4

advertisement
Achieving a Readable Style
CHAPTER OBJECTIVES
The objectives of this chapter are to




Explain how to achieve a readable style.
Illustrate various methods that one may use to write effective paragraphs.
Explain how knowledge of one’s audience is central to achieving a readable style.
Provide guidelines for writing readable sentences.
TEACHING STRATEGIES
This chapter departs significantly from the style chapter in previous editions of Reporting
Technical Information because it places heavy emphasis on style as a response to audience
needs and expectations. Students are shown that style guidelines are not just arbitrary rules
created in a vacuum but are strategies born out of audience frustration with unreadable
documents.
A chapter like this one is also a wonderful way to get students on your side and headed in the
same direction as you. You have a common enemy—wordy, pompous, bureaucratic writing.
And the focus is not grammar and usage rules, which for some students is just so much hairsplitting. You can point out that most of the material in Chapter 4 has nothing to do with
grammatical correctness at all.
For these reasons, students usually get intrigued with a chapter like this one on writing style
problems. Instead of merely being told to write more clearly and succinctly, this chapter
shows students specific stylistic problems that hinder that goal. They learn how to spot these
kinds of problems and how to fix them.
A good time in the semester to use this chapter is that period in which your students are hard
at work on a major writing project. You probably don’t want to saddle them with any
additional out-of-class work, so have them read this chapter and conduct several in-class
workshops on writing style.
WORKSHOP ACTIVITIES
As mentioned previously, this chapter is a good one for in-class workshops. It’s a good way
to keep students active, focused, and learning while they are working on a large report
project outside of class.
76
Traditional Classroom
1. Revise paragraphs with weak or absent central statements, paragraphs with weak
transitions, and overly long paragraphs. It’s easy enough to create problem paragraphs
by yanking out the central statement and most of the transitions from well-written
paragraphs with interesting content. Have students work over these paragraphs on their
own, in teams, or with the entire class.
2. Revise paragraphs to include lists and tables. Find excerpts with lists, and rewrite
them as straight-text paragraphs. Find excerpts with simple informal tables, and rewrite
them as straight-text paragraphs. Have your students reformat these paragraphs back into
lists and tables.
3. Revise sentences with overly long openers, overly long interrupters, and sentences
that are just too long. If you have a perverse streak, you can rewrite sentences that have
these characteristics. Also, you can now visit the Web sites of many state and federal
agencies to find plenty of text that meets all of these qualifications. Have your students
work on these kinds of sentences on their own, in teams, or with the entire class.
4. Revise sentences with excessive noun strings, ineffective normalizations, and bad
passive-voice constructions. Collect sentences with these characteristics and have your
students revise them. (Once again, state and federal agency Web sites are good sources
for this sort of material.)
5. Declare an opposite day. For fun, have students rewrite good, straightforward sentences
with the sentence-style problems covered in this chapter. Have them rewrite active voice
to passive voice; jam nouns together in long noun strings; knock the action right out of
the sentences; begin with interminable openers; and interrupt the subject and verb with
huge modifiers.
6. Hold a bureaucrat face-off or bureaucrat showdown. If it’s not in poor taste, consider
having the bureaucratic prose equivalent of the pun-off. With a revolving panel of student
judges and student contestants, act as master of ceremonies and read out perfectly good
sentences and give contestants a couple of minutes to rewrite these sentences in
bureaucratese.
Computer Classroom
1. Practice revising online. Online revision—writers working on the same document but
from different locations—presents a new array of benefits and challenges. Give students
a paragraph to revise online. Either assign or let them choose the method(s) of
communication: e-mail, chat room or IRC, FTP to and from the Web, etc. Let them
struggle through the awkwardness of finding a way to ensure which document version is
most recent, ensuring that the revisions are consistent and correct, etc. Discuss these
experiences as a group afterwards.
77
2. Find online style guides. Have students (individually or in pairs) search the Web for
online style guides. These guides may be as universally applicable as our textbook or
much more field-specific. Discuss what they find, and compile a list of helpful Web sites
to support their revision work.
3. Find online advice for writing for the Web. Have students search the Web for advice
on writing for the Web. Have students compile a list of helpful Web sites they may use
later when they create a Web site as an assignment in this course.
WRITING PROJECTS
As mentioned earlier, this chapter is ideal for the change-of-pace, workshop-style unit that
you can conduct when your students are hard at work on the formal report. Here is a small
selection of ideas:
Traditional Assignments
1. Write a memo on an example of bad writing. Have your students find a short excerpt
containing stylistically bad writing, yet writing that illustrates the ideas discussed in this
chapter. Have them write a memo in which they identify and discuss these problems, and
then have them rewrite the excerpt. If some students don’t know where to start, suggest
that they visit the Web sites of state and federal agencies, where they can find text
meeting these qualifications.
2. Rewrite good text as bad. Use the idea in item 5 in the workshop activities above. Have
your students take perfectly good, straightforward text and inject all manner of the
stylistic problems covered in Chapter 4.
3. Revise a poorly written document to improve its style. Provide students with a
document that is a stylistic disaster, and have the students rewrite the document.
Distance Learning Assignments
1. Participate in an online peer review before a major assignment submission. Have
students trade drafts of one of their larger assignments at least three days before the due
date. Require peer reviewers to study their classmates’ drafts and suggest style revisions,
using the Revision Checklist handout at the end of this section. Make sure to explain the
difference between revising style and editing mechanics. Also, consider having a
minimum number of remarks—any combination of constructive criticism and
compliments—per review. Also consider offering examples of good, specific remarks
(“This sentence is written in passive voice.”) versus vague, overly general remarks (“This
sentence sounds weird.”). Make sure to set a peer review deadline that gives students
time to get their peer remarks and apply necessary changes to their drafts before
submitting their assignments. To reinforce the seriousness of this peer review assignment,
78
you can ask that copies of the review remarks be sent to you. For more on work
shopping, see the front section of this manual.
2. Write and respond to a letter of complaint. Require students to compose a letter of
complaint to the provider of a product/service of their choosing. They may pick the
writing style and tone of the complaint. Collect these online (as e-mail messages,
electronic files, or discussion thread postings), and then redistribute them each to a new
student. Require them to first write a short paragraph putting themselves in the audience’s
place (the one receiving the complaint) and describing their attitudes, motivations, etc.
Next, have them respond to the letter of complaint with a solution, a reason for not
complying with the complainer’s wish, etc. If you have time and are interested, you can
then have the original letter writers post an e-mail or discussion message describing how
they reacted to their complaint letter responses and reflecting on how writing style and
tone help achieve purpose.
3. Analyze a Web site that uses a poor writing style. Have students locate a Web site that
has stylistic problems, and then take on the role of a Web site design consultant who has
been approached by the Web master (or site owner or sponsor) to help improve it. Using
guidelines from the list of Web sites gathered in the third computer classroom assignment
above, have the students analyze the style problems on the problem site. The students
must then write an e-mail to the Web master (which they will, of course, actually send to
you) in which they analyze the style problems on the site and make specific suggestions
for improvements. If your students are comfortable with Web design, they may even
redesign the site itself and include the HTML page as an attachment to the e-mail.
RELEVANT LINKS






Strunk’s Elements of Style (http://www.bartleby.com/141/)
Sections and Paragraphs
(http://www.svcc.edu/academics/classes/okeyd/eng111/ch3paragraphs.htm)
Dr. Ronald B. Standler’s Technical Writing (http://www.rbs0.com/tw.htm)
Guide to a Scientific Writing Style
(http://voxlibris.claremont.edu/research/lrs/science_cit.htm)
Indispensable Writing Resources
(http://www.quintcareers.com/writing/science_writing.html)
Analytical Writing for Science and Technology
(http://mywebpages.comcast.net/tgeorges/write/index.html)
WORKSHEETS
You may wish to reproduce the following worksheets for use in class or as homework.
79
Style Revision Worksheet
Sentence Revision 1
On a separate sheet of paper, identify the types of writing problems presented in
Chapter 4 that you see in the following excerpt, and then rewrite it in clear, forceful
prose:
While determination of specific space needs and access cannot be accomplished until after a
programmatic configuration is developed, it is apparent that physical space is excessive and
that all appropriate means should be pursued to ensure that the entire physical plant is
utilized as fully as feasible.
Sentence Revision 2
On a separate sheet of paper, identify the style problems in this pompous paragraph
and rewrite it:
The purpose of this PPM [Policy and Procedure Memorandum] is to ensure, to the maximum
extent practicable, that highway locations and designs reflect and are consistent with Federal,
State, and local goals and objectives. The rules, policies, and procedures established by this
PPM are intended to afford full opportunity for effective public participation in the
consideration of highway location and design proposals by highway departments before
submission to the Federal Highway Administration for approval. They provide a medium for
free and open discussion and are designed to encourage early and amicable resolution of
controversial issues that may arise.
Paragraph Revision 1
On a separate sheet of paper, turn the following sentence into a paragraph of several
sentences. Try reformatting part of the paragraph as lists. Make the central idea of the
paragraph the first sentence:
If, on the date of opening of bid or evaluation of proposals, the average market price of
domestic wool of usable grades is not more than 10 percent above the average of the prices
of representative types and grades of domestic wools in the wool category which includes the
wool required by the specifications (see (f) below), which prices reflect the current incentive
price as established by the Secretary of Agriculture, and if reasonable bids or proposals have
been received for the advertised quantity offering 100 percent domestic wools, the contract
will be awarded for domestically produced articles using 100 percent domestic wools, and
the procedure set forth in (e) and (f) below will be disregarded.
80
Revision Checklist
Use this checklist to analyze your writing or that of others.
Paragraphs

Use strong central statements
(topic sentences).

Maintain coherence.

Keep paragraphs to moderate
length.

Use transitions.

Use lists when they will help
convey meaning.
Comments:
Sentences

Use variety of length, but seek
moderate length (check sentences
over 20 words).

Keep subjects and verbs close
together.

Omit verbiage; use concrete verbs.

Write squeaky-clean prose.

Avoid ponderous language.

Avoid excessive use of is/are verb
forms.

Use active voice for clarity.

Define when necessary.
81
Revising a Poorly Written Memo
Memo Background:
The Big Chief plant has just hired Mike Sims as a production manager. Although Sims has
three years’ experience in the field, this is his first managerial position. He is collegeeducated and very excited about this new opportunity. On his first day at work, the company
vice president asks Sims to write a memo introducing himself to the fifty production workers
he will be supervising. Sims’s memo is on the next page.
1. Study the old memo, making specific notes on your copy, in terms of Sims’s primary
audience and purpose, sentence structure (active versus passive), specific word choice, tone
and point of view, and general professional writing goals.
2. Evaluate the original document’s style in terms of the strategies and recommendations in
Chapter 4. Tell me where the original fails to use good (appropriate) writing, why the
inappropriate wording will have a negative effect on the document’s success, and how the
memo can be improved.
3. Thoroughly revise Sims’s poorly written memo. Be sure to correctly and thoroughly
apply all of the good style from the reading. You may change wording, but be careful not to
change the memo’s central message.
82
To: All Big Chief Floor Workers
Date: 31 January 2001
From: Mr. Mike Sims, Production Manager
Re: New Procedures
This memo shall open by expressing the author’s exhilaration concerning the tremendous
opportunity afforded to him as the new production manager for Big Chief. Employees will
find the author’s management style emphasizes the implementation of optimum
operationalization, which, of course, leads to ultimate productivity and fiscal liquidity!
Promotion of an effective working environment, based on the latest principles of Total
Quality Management, will help launch the Big Chief name to the top of our industrial milieu.
As part of the new TQM strategy, a new, more open worker-manager communication
strategy has been implemented, EFFECTIVE IMMEDIATELY. Issues or suggestions may
now be brought to the management’s attention via two avenues: a cork-product bulletin
board in the break room and direct, interactive appointment. Suggestions may be
anonymously posted in the break room as the board will be used as an interactive, divisionwide interchange, with employees and the manager being offered the chance to interface in a
public forum. The procedures for using the appointed board are as follows: Obtain an
anonymous suggestions form from the author’s secretary. Scribe the date and subject of the
suggestion in the top lines provided on the form. Then legibly print the issue at hand within
the parameters of the space thus provided. Commentary which is illegible will be
disregarded.
Employees who wish to discuss an issue with management directly may also do so via
person-to-person appointment. Fifteen minute appointments will be available for assignment
each Friday during the production worker lunch hour (12:00-1:00). These should be taken
advantage of if any private dilemmas are of concern. Participants should COME
PREPARED.
83
Revising a Poorly Written Letter
Background:
Dr. Winston works for a major university that has a notorious problem with insufficient
parking. Winston decides to write a letter of complaint to PTTS, the on-campus traffic and
parking regulators.
1. Study the old letter, making specific notes on your copy, in terms of Winston’s primary
audience and purpose, general professional writing goals, and how the letter’s style
complements or fights against these. Winston’s letter is on the next page.
2. Evaluate the original document’s style in terms of the strategies and recommendations in
Chapter 4. Tell me where the original fails to use good (appropriate) writing, why the
inappropriate wording will have a negative effect on the document’s success, and how the
letter can be improved.
3. Thoroughly revise Winston’s poorly written letter. Be sure to correctly and thoroughly
apply all of the good style from the reading. You may change wording, but be careful not to
change the letter’s central message.
84
1000 Pebble Creek Drive
College Station, TX 77845
September 30, 2000
Parking Traffic and Transportation
Texas A&M University
College Station, TX 77843-5555
Gentlemen:
Having trodden upon sore foot one too many times, this calloused parking participant would
like to address copious vehicular positioning overflow at this prestigious university, so well
known for both its scientific research and impassioned parking police.
An amount of money has been invested by me for parking privileges that is disappropriately
incongruent with the afforded car-storage opportunities. Although the appropriated funding
was paid with the intent to secure a “24-Hour Reserve” spot in lot five, you have failed to
provide the aforementioned author with the befitting service rendered. It is not an uncommon
occurrence to arrive at the appointed parking space (#6524A) to find that a student, tardy,
tenacious, and intrepid, has borrowed the author’s area in order that he or she might
punctually enter the academic environment. This, however, is not necessarily the student’s
fault; Texas A&M is notorious for overselling its commuter tags to the point of parking
impossibility! Regardless of that fact, the epoch it takes this speaker to contact a parking
attendant, secure a tower, and have the offending vehicle removed requires such a significant
time investment that it is rendered impossible. And where do you suppose I might park my
own vehicle whilst awaiting the previously aforementioned process to ensue?
The committance of a FRAUDULENT ACT is performed each and every time you accept
payment and compensation for services that you have no honest intention of providing. It is a
slap in the face of the American system of judicious capitalism, for which a LAWSUIT
should be suggested. However, in a display of greater reserve and patience, these alternative
actions are hereby demanded: station a manned parking kiosk at the lot entrance to repulse
any illegal parking attempts, arm attendants with instantaneous tow truck access which
requires no phone calls and no wait, and commission new parking-overflow strategies for
those paying customers who need an emergency alternative.
How this university can afford to build a system of new athletic facilities while ignoring the
basic requisite of parking in order to attend to academic priorities is beyond this author’s
cognitive ability . Perhaps Texas A&M should be designated a health spa, and all academics
should be foresaken!
Sincerely,
(ink signature)
L. T. Winston, Ph.D., Assistant Professor
85
Revising a Poorly Written Application Letter
Background:
KBQS (Knowledge Bound Quality Systems, Inc.) is a small, local technical writing firm. The
Denver location employs about ten people, so it has no “personnel department.” One of the
two company presidents will probably be the one taking the applications in addition to
accomplishing her other daily tasks. The firm is very busy, so the pressure is high, especially
considering that another technical writer is needed but not yet hired. KBQS put a technical
writer ad in the newspaper last Sunday and received ten responses this week.
1. Study the old letter, making specific notes on your copy, in terms of Lance’s primary
audience and purpose, general professional writing goals, and how the letter’s style
complements or fights against these. Lance’s letter is on the next page.
2. Evaluate the original document’s style in terms of the strategies and recommendations in
Chapter 4. Tell me where the original fails to use good (appropriate) writing, why the
inappropriate wording will have a negative effect on the document’s success, and how the
letter can be improved.
3. Thoroughly revise Lance’s poorly written letter. Be sure to correctly and thoroughly
apply all of the good style from the reading. You may change wording, but be careful not to
change the letter’s central message.
86
100 Pine Street
Denver, CO 55555
September 1, 2000
KBSI Inc.
123 First Avenue
Denver, CO 55556
Sirs:
Technical writing is the sort of professional field into which not just anyone should venture.
Certain requirements like attention to detail, knowledge of the subject matter at hand, and a
calm, calculating approach are central to it. This means that you should interview me for the
position advertised in Sunday’s paper.
Prestigious pedagogy and a thoroughly contemporary curriculum have been combined to
make the applicant before you a paramount choice for adoption. A review of my skills will
reveal that I am not unskilled at composition for both knowledgeable and ignorant audiences.
Techniques such as information mapping, audience profile matrixing, and state of the art,
computer aided vocabulary proficiency ratings will all be put into practice as I take the helm
in the writer's job.
You will be impressed once you are appropriately cognizant of how my greatly enhanced
skills can be put to work to produce monolithically successful documents unparalleled in
excellence. It is not uncommon for my first-revision results to be indicative of terminal
document design!
A recently completed degree is a plus for me as a technical writing applicant. I have my
course work fresh in my mind, and I am ready to face the world! School has taught me a
plethora of prestidigitations, all of which I am ready to put to work for you. Beneficial results
will dominate the future due to KBSI’s choice in pursuing this application. As many fine
organizations are currently within my perusal, I urge you to contact me soon to discuss
application details.
Sincerely,
(ink signature)
Pat Lance
87
OVERHEADS
The figures on the following pages may be reproduced as overhead transparencies or simply
shown on a computer. The following set of discussion questions associated with each of the
figures may be used to elicit student reflections on the concepts.
Discussion Questions for Figure 4-1


In what circumstances would following these principles be critical to document
success?
Can you imagine a context in which it would be less critical?
Discussion Questions for Figure 4-2


To what extent do the paragraphs in your writing follow these guidelines?
Have readers ever struggled to understand your writing? To what extent might
following these guidelines improve your communication?
Discussion Questions for Figure 4-3



Which of these elements do you typically consider when you revise your sentences?
Which ones represent weaknesses in your writing (the things instructors mark in the
margins!)?
In what ways have these weaknesses hindered your ability to convey your meaning?
88
Basic Principles of Effective Style
 Determine your reader’s knowledge of the
subject
 Determine if a particular style will be expected
 Anticipate your reader’s comprehension level
in a given context
 Know your relationship to your reader and how
you want to sound
 Adjust the style to the reader, the purpose,
and the context
Figure 4-1: Basic Principles of Effective Style
Revising Paragraphs
 Begin paragraphs with topic sentences
(central statements)
 Build paragraphs with a group of sentences
that coherently develop the central
statement
 Use a moderate paragraph length
 Use transitions between ideas
 Use lists when they better emphasize and
develop the topic ideas
Figure 4-2: Revising Paragraphs
Revising Sentences

Select your level of language; adjust the density
of information

Watch sentence length

Keep subjects and verbs close together

Omit verbiage; use concrete verbs

Write squeaky-clean prose

Avoid ponderous language

Avoid excessive use of is/are verb forms

Use active voice for clarity

Define when necessary

Avoid impersonal language
Figure 4-3: Revising Sentences
Download