Technical Editors' Eyrie Photo of Osprey
Resources for technical editors Home page About technical editing Books Tips, techniques and checklists Links to other resources Newsletter archives Site index Search this site Business basics: marketing, website development, and more

 

Newsletter

Issue 24, 7 October 1999

ISSN 1442-8652

Editor: Jean Hollis Weber
jean@jeanweber.com
http://www.jeanweber.com

In this issue...

Feature article: Training subject-matter experts to review (edit) documents
Final installment: Collecting your e-mail when travelling (Part 4)
Defining the role of the technical editor
Subscription information


Feature article: Training subject-matter experts to review (edit) documents

Editor's note: This article began life as a note to the Technical Writers' discussion list (TECHWR-L) on 5 April 1999, and is reprinted here with the permission of the author, Steve English ( SEnglish@MICROS.COM ). Please note that Steve is using the phrase "tech edit" to describe what I would call a "tech review," but I think the issue he raises, and the solution he's found, are relevant to many editors' work.

I read with interest the thread on trying to get busy SMEs (subject matter experts) to do tech edits that focus on content, and I have a question for the list:

Have any of you have ever taught your SMEs *how* to do a tech edit?

I thought so. Kudos to all two of you who said yes. If you are like most writers, you assume that someone taught these people to do tech edits before you met them. If they are like most SMEs, you are wrong. I would like to share my experience with tech editors at a little company.

English's Theory of SMEs #1: Developers are people who like to think of themselves as highly competent solution providers. If they didn't need and enjoy control over their job content, they would have majored in Sociology. It makes them nervous and uncomfortable to be tasked with something they don't really know how to do. This in turn makes them reluctant to do it.

When I was working on a long-term project with a group of mostly new SMEs, I held a lunch conference on the topic, "How To Do Tech Edits". I reserved the conference room for noon and told the developers and QA people to bring their lunches, and I would provide dessert. I expected 5 or 6 people to sign up. I got 17.

English's Theory of SMEs #2: Developers are like bears -- they move slowly, have sharp teeth and claws, and snarl a lot, but are powerless to resist honey. I tried to avoid serving something lame like punch and cookies. Fortunately momma taught me a little about baking. I get my best results from strawberry shortcake.

After the bears shuffled into the room, took their seats, and finished making fun of each other's lunch choices, I said, "Let's start off with a little exercise. Let's do a technical edit of the following paragraph. Call out any errors you find, and I'll circle them with a red pen. John, you keep count of how many we find." I then used the overhead projector to display a paragraph similar to the following (technical terms changed here to protect the guilty):

"Their are too weighs to framjistam the beniculator usiing a 3700 pod bays; begins the framjistam using a bleak grey pony (well brushed, or artickyoolate sum of this beniculators with, a careful approaches to languorous amour;"

We then went around the room pointing out mistakes in the paragraph. If I was actually using the example above, I could count on the developers to come up with anywhere from ten to fourteen errors. Then I dropped the bomb.

"Thank you. These are all good observations. They are also all wrong, because this was a trick question, for which I humbly apologize. But when we began, I said, 'let's do a TECHNICAL edit'. From a technical edit standpoint, there are only two mistakes in this paragraph, and none of you mentioned them. There are actually three ways to framjistam the beniculator, not two. So this documentation is incomplete. And 3700s don't use pod bays, they use docking ports. So this documentation is inaccurate."

In the deafening silence that ensued, I went on to make the following points:

I got good results from this approach. The quality and punctuality of tech edits went up as SMEs stopped focusing on my creative use of punctuation, etc., and they were happy in the belief that I had simplified and shortened the task. Some of them are still my friends, despite that incident the night of the release party ... But this post is long enough already without going into that.


Final installment: Collecting your e-mail when travelling (Part 4)

The first part of this article appeared in Issue 21 of this newsletter, 26 August 1999: http://www.jeanweber.com/news/tenews21.htm#feature21

The second part appeared in Issue 22, 9 September 1999: http://www.jeanweber.com/news/tenews22.htm#feature22

The third part appeared in Issue 23, 23 September 1999: http://www.jeanweber.com/news/tenews23.htm#feature23

This article covers:

In some cases, public-access terminals only cater for Web- based e-mail access. In other cases, you can collect mail from POP3 accounts as described in this section.

To collect your e-mail, you need to follow the same steps as described in "Collecting your e-mail using someone else's computer" in parts 2 and 3 of this series, with two exceptions:

Here are the steps:

  1. Change existing account information to yours.
  2. Collect and send mail as usual.
  3. Delete your account information.

Step 1. Change existing account information to yours

A public-access terminal might be set up to accept your user information on a form that is different from the ones supplied with the usual e-mail readers. If that is the case, use whatever form is presented to you. Otherwise, here are the instructions for filling your information into an existing account (probably set up as "Guest" or a similar name), using Netscape Communicator, Outlook Express or Eudora Light.

Changing an existing account in Netscape Communicator 4.5

  1. Open Netscape Communicator.
     
  2. On the Edit menu, click Preferences.
     
  3. On the Identity page of the Preferences, fill in your name, e-mail address and reply-to address.
     
  4. On the Mail Servers page:
     
    • Fill in your outgoing mail server information.
       
    • Click Edit to display the Mail Server Properties page, where you fill in your incoming mail server information.
       
    • Click OK to return to the Mail Servers page.

Changing an existing account in Outlook Express 98

  1. On the Tools menu, click Accounts.
     
  2. On the Mail page of the Internet Accounts dialog, choose an existing account name and click the Properties button.
     
  3. On the Servers tab of the Account Properties dialog, change the incoming mail server names and the logon account name to yours.

Changing an existing account in Eudora Light 3.0

  1. On the Tools menu, click Options.
     
  2. Click the Personal Info and Hosts icons in the left-hand pane and change the settings to the ones you recorded from your setup at home.


Defining the role of the technical editor

Moved to http://www.jeanweber.com/about/responsi.htm.


© Copyright 1999, Jean Hollis Weber. All rights reserved.

You may forward this newsletter (in whole or in part) to friends and colleagues, as long as you retain this copyright and subscription information, and do not charge any fee.

Subscription information

This newsletter is no longer being published.

Privacy statement

I do not sell, rent, or give my mailing list to anyone.