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.
>> 1. Edit > Find > Replace > All
>
> Readers can indeed probably figure out what you
> mean but your solution seems to me to be the
> equivalent of writing a sentence of all nouns
> without any verbs. I think that adding a simple
> imperative verb makes the instruction clearer
> and the step would be more quickly read and
> comprehended.
Yes, that isn't unreasonable--it communicates in a standard way--but is
one of the most common types of instruction. I'm not so sure that
anything is gained by sticking to standards at the level of the
ordinary, mundane instruction.
I forget where I first saw it done as Edit > Find > ..., but I'm drawn
to it as the atheistic alternative to the religious beliefs about the
right standard way. I do want written knowledge transfer to be
progressive. It needn't be stuck in 1980 vocabulary reflecting concerns
about how to get people to use a mouse! We've learned that mousing isn't
a big problem area requiring finely segmented vocabulary. Haven't we?
Ned Bedinger
doc -at- edwordsmith -dot- com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial. http://www.componentone.com/DocToHelp/
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
