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.
> Chris Borokowski wondered: <<You might carry out
> your laundry, but is
> this the best usage we can find for what is done
> when a command is
> executed? Ex: To carry out the command, click Run.
> The lights on your
> hard drive will flash as it is formatted.>>
>
> The best solution is to eliminate all vague,
> non-specific phrasal
> verbs and replace them with a verb that describes
> the actual action.
> Here: "To format your hard drive, click Run."
>
> If the context is already painfully clear (e.g., the
> sentence that
> introduces a series of steps says "Perform the
> following steps to
> format your hard drive"), you can simply eliminate
> the verb and list
> the steps. The context is clear enough that (in most
> cases) it does
> not require repetition. The exception is for an
> obvious situation
> such as providing a warning. For example: "Warning:
> If you perform
> the next step in this procedure, formatting will
> begin and all
> information on your hard drive will be erased."
>
> Note that in this example, the message does not just
> repeat a
> description of the task: it conveys the meaning and
> consequences of
> the task. That's important, particularly for readers
> who may not
> understand the task fully.
>
>
> ----------------------------------------------------
> -- Geoff Hart
> ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com
> www.geoff-hart.com
> --------------------------------------------------
> Coming soon: _Effective onscreen editing_
> (http://www.geoff-hart.com/
> home/onscreen-book.htm)
>
>
____________________________________________________________________________________Pinpoint customers who are looking for what you sell. http://searchmarketing.yahoo.com/
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
Now shipping: Help & Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help & Manual: http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-