As I Was Saying…

Chatter, memories and rants. Please, don't stop me if you've heard this one before.





Personal Blogs - BlogCatalog Blog Directory



  • Shameless plug for my daughter Elizabeth's blog...

I Don't Have an iPod, But My Mom Does

Confessions from the New New Frontier

Restuck in time

Monday, May 31, 2010 - 10:30 pm - My parents joke that when I was born in the summer of 1980, I joined my childhood already ten or fifteen years in progress. Like everything really funny, there is a lot of truth to it. In elementary school, for example, I listened to Billy Joel instead of New Kids on the Block and my [...]

The fat thing

Tuesday, July 7, 2009 - 2:58 am - My roommate my freshman year of college once told me, “You’re a bigger girl, but it works for you.” I recall that at the time, I was pretty crushed. She fretted when clothes ran small and a size 2 wouldn’t fit, once semi-bragged that she never allowed herself to eat more than 15 grams of [...]

In defense of ?America?

Sunday, March 22, 2009 - 2:24 pm - Orwell was a patriot, a patriot in the sense that he was able to identify things as characteristically “English” which he admired and felt a sense, however intangible, of personal pride in being associated with them. At the same time, he was very open in public and in private about his fierce opposition to British [...]

A belated answer

Tuesday, February 10, 2009 - 11:22 pm - Part of the hiring process in the English Department at UMB is going out to lunch with a group of students so they can check you out and pass along their impressions to the faculty. Yesterday, I was one of these student representatives, and the complimentary buffet isn’t the only thing I’ve chewing on since. [...]

A Tech Writer’s Inadvertent Memoirs

May 22, 2009

Years and years ago, I taught technical writing at the University of Tulsa. I wore out my students by telling them again and again that they should aim for voiceless writing. What I meant was writing that didn’t hint at the person behind the writing.  “Imagine yourself as the reader,” I would say. “When you’re trying to follow the instructions to put a gas grill together, you want the manual to be about the gas grill, not the person who wrote the manual.”

It’s sound advice for aspiring tech writers, easy to give but sometimes more difficult to follow. Voiceless, for example, is not the same thing as nonhuman! Consider this gem selected more or less at random from the instructions for IRS Form 1040:

If your economic stimulus payment was directly deposited to a tax-favored account and you withdraw the payment by the due date of your return (including extensions), the amount withdrawn will not be taxed and no additional tax or penalty will apply. For a Coverdell education savings account, the withdrawal can be made by the later of the above date or June 1, 2009. See the instructions for lines 15a and 15b, 21, and 59.

All those passive verbs invite me to imagine faceless drones swarming in a glass and steel hive. For all I know, of course, tax form instructions may really be machine generated. The IRS as The Borg.

At the other extreme, the writer becomes fully visible on the page. I sometimes like it when it’s done deliberately. In a professional journal I edited for several years, the author of a particularly complex article added a footnote about three quarters of the way through that said something like “If you’re still with me here, please let me know and I’ll buy you a cup of coffee!”

The problem I tried to warn my students about, however, was more subtle.  Last Christmas, for example, I was given a new alarm clock that has features the manufacturer is pretty excited about. The writer of the owner’s manual pretty obviously was charged with emphasizing these features, particularly the fact that the clock sets itself. Here’s what the manual says:

We all know how annoying it is to wake up in the morning and see the dreaded flashing “12:00” display on our clocks or clock radios. This means that your power was interrupted some time during the night while you were sleeping and your clock doesn’t know what time it is anymore. Unfortunately, it probably also means that you are late for work, or for school, again.

What do we know about the writer here? I think the story is mostly told in that final again.  The writer is someone who has no chance of waking up on time without an alarm, perhaps as a result of staying up too late. It’s also someone who has tried the “my alarm didn’t go off” excuse a few too many times. When I consider this in combination with the sloppy and abrupt pronoun switch from we to you after the first sentence, I get a pretty clear picture of the writer:  habitually running late, lacking focus, desperately striving to please but unwilling or unable to give the work the final edit it needs.

This is someone I would probably find exhausting to have around, and that’s a thought I shouldn’t be having at all as I read the manual. After all, I’m just trying to figure how to use my new clock! I don’t want to hear about roommate troubles, sleep issues, the saga of a psycho ex, and so on.

And that’s why all those years ago at TU, I used to sound like a broken record: “Get the information on the page, kids. Keep yourself off the page.”

One Response to “A Tech Writer’s Inadvertent Memoirs”

  1. Darlene Says:

    Thank you for a good lesson in writing. I am sure I am guilty of inserting my opinions when writing instructions. I am especially guilty when giving instructions to a family member. I think in blog terms this is a ‘me me’.

Leave a Reply

XHTML: You can use these tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>