TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: repetitive text and voice From:Scott Miller <smiller -at- CORP -dot- PORTAL -dot- COM> Date:Fri, 26 Jun 1998 08:34:57 -0700
I have to agree with the judges. In a brochure like this, the
information is not something you're going to sink into like a warm bath
and stay a while. You just want to get in and out as fast as possible to
find the REAL information. So, providing a consistent wording for each
paragraph makes it easier and quicker to read. By the third description,
your mind simply zips over it.
However, if you're constantly changing the wording, your mind recognizes
something new, and has to figure out if there is any new meaning behind
this new wording. For example, when faced with "In this section..."
versus "In this category..." is there a meaningful difference between
sections and categories? Am I more interested in a category? Is a
category built from sections, or vice-versa?
With all these different wordings, I get the impression that you have a
sort of raggedy set of documents. Some are sections, some are
categories, some are "research," some are areas... Yikes. I picture a
set of documents of wildly different formats, sizes, and content
delivery. With this much variety, some sections, I imagine, are better
than others. This makes me wonder: When I access a section, will it be a
good section, or a bad one? Then I begin questioning the quality of the
whole darn database.
Well. You try to write something that isn't boring, and look what
happens. In this case, boring is OK. The reader isn't going to be around
long enough to get bored.
- Scott Miller
smiller -at- portal -dot- com
-----------------------------------------
> In this past year's STC publications competition, some of the judges
> objected to this "shifting voice".
>