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.
RE: Levels of detail -- are we beyond this? (take II)
Subject:RE: Levels of detail -- are we beyond this? (take II) From:"Combs, Richard" <richard -dot- combs -at- Polycom -dot- com> To:"Evelyn Lee Barney" <evbarney -at- comcast -dot- net>, "Geoff Hart" <ghart -at- videotron -dot- ca> Date:Fri, 15 Aug 2008 16:09:45 -0600
Evelyn Lee Barney wrote:
> Aww now Geoff - i wasn't gonna name names - but YES - darn it all.
they
> are the worst offenders of this kind I'm familiar with.
>
> Ev
>
> Geoff Hart wrote:
> >
> >
> > Did anyone say "Adobe"? <g> I'm hardly what you'd call naive about
> > computers, and I use some parts of Creative Suite heavily and other
> > parts erratically, but I often run into precisely this kind of
> > instruction, and have to dig deeper into the online help (sometimes
a
> > really deep dig) to find out just what the heck they're talking
about,
> > by which time I've half-forgotten the original question that sent me
> > to the documentation.
Absolutely. For years, many of us (myself included) have derided
"Microsoft-type help": "In the X field, type an X. From the Y list,
select a Y. ..." But at least they tell you where to find everything.
Adobe seems to have adopted an "enumerate the capabilities" style: "You
can do A to your widget. You can customize it by doing B. Or you can
supersize it by applying C." No clue as to where one might find A, B, or
C. No links to them in the help. And at least one of the three isn't in
the index.
And for the next upgrade, they'll reshuffle the menus again, so you have
to hunt around even for the familiar functions.
Oh, yeah, and the install probably won't work.
<grumble-grumble />
Richard
Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-777-0436
------
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-