Re: Capitalizing...research need

Subject: Re: Capitalizing...research need
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 27 Jan 2005 12:17:58 -0800


SW is not our main business (our SW "product" is a tool that our
customers use to configure and install our main product), so to be
frank we don't expend as much effort on our SW docs as we do
on the rest of our products, but one convention we do follow is to
not pepper the instructions with the names of dialogs or windows
over and over again. The bolded title is used once at the beginning
of the instruction, and thereafter the text refers only to its contents,
says "this tab," or something along those lines. We also make heavy
use of screen caps, numbered callouts and fragmented statements
(example: if there's a button called "Run," there's a numbered arrow
pointing at it in the screen cap, and below the figure a description
that says "(#) does blahblahblah," rather than "Run button: does
blahblahblah").

Gene Kim-Eng


"Chuck Martin" <cm -at- writeforyou -dot- com> wrote in message news:...
>
> The bolding catches users' eyes (like links on a web page), and too much
> bolding distracts them from important points. More often than not, the
> most important points are going to be your procedural text; users are
> reading the docs because thay can't figure out from the interface how to
> get a particular task done. If the interaction points are the only ones
> bolded, users can just scan the bolded text and get a very good idea of
> what to do without even reading comprehensively.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo:
http://www.webworks.com/techwr-l

Technical Communication Certificate online - Malaspina-University College, Canada. Online training in technical writing, software (FrameMaker, RoboHelp, Dreamweaver, Acrobat), document & web design, writing manuals, job search. www.pr.mala.bc.ca/tech_comm.htm for details.

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



Follow-Ups:

References:
Capitalizing...research need: From: Erica Bruce
Re: Capitalizing...research need: From: David Neeley

Previous by Author: Re: Capitalizing...research need
Next by Author: Re: Convincing leaders and management of the value of technical editing
Previous by Thread: Re: Capitalizing...research need
Next by Thread: RE: Capitalizing...research need


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


Sponsored Ads