Re: Writing simple procedures

Subject: Re: Writing simple procedures
From: chuckm -at- MDHOST -dot- CSE -dot- TEK -dot- COM
Date: Thu, 4 May 1995 11:19:28 PDT

Glenda Jeffery wrote:


> I have a question about this -- at what point is something so
> obvious that you don't want to break it out into two steps?
> For example:

> 1. Move the cursor to the XXX toolbox.
> 2. Click on the YYY icon.
> ...

> or

> 1. Click on the YYY icon in the XXX toolbox.
> ...

> Is the first form too obvious? It seems so to me, but then
> again, you want to write these kinds of things to the lowest
> common denominator, right?

I believe in providing as little information as required to complete
the task. In every Windows manual I've worked on I start the manual
by stating that "we" expect the user to know how to use Windows.
Thus, we don't explain how to select menus or icons, open folders or
anything else that someone using Windows ought to know. Our manual
is about our product, not Windows. Microsoft can explain how to use

I've noticed the same thing about Macintosh software manuals. The manual
writer always states that the manual assumes the user knows how to
use the Macintosh. The software manuals do not explain how to use
the mouse, how to double-click, how to select icons, how to copy
files to other directories or disks, etc.

Thus, in the examples above, I would use the second form. It is simpler;
it provides enough information to complete the task.

OTOH, if you wanted to write to a lower level, you could even rewrite
step 1 as: Move the mouse to locate the cursor over the XXX toolbox.
After all, as it written above, step 1 doesn't explain how to move the
cursor. :-)

Since most users refer to the manual when they have a problem rather than
how to learn to use the software, I prefer to get to the point as quickly
as possible.

Have Phun,


Previous by Author: How to get ISBN?
Next by Author: Re: Style Guide... /These aren't doc. style guides.
Previous by Thread: Re: Writing simple procedures
Next by Thread: Re: Writing simple procedures

What this post helpful? Share it with friends and colleagues:

Sponsored Ads