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.
Plus, to the extent a particular feature is difficult to use, that
feature won't be used, and the UI will have to be improved. There's a
point at which documentation cannot overcome poor usability. But true,
excellent documentation can compensate for poor usability.
But think of the many years we've all gone without using the more
advanced features of simple ("") tools like Word, Outlook, Excel, etc.
How many times have you thought, "Yeah, I've got to get into the manual
and learn that really cool feature one of these days." I guess that
won't deter Microsoft from continuing to build advanced features into
these products, even in subsequent releases. There are always one or
two people in the world who use them.
Or think of your mobile phone. Every time I get a new phone, I think,
"Yeah, I'm going to sit down and really read that user's guide and see
what all the features are." And I never get around to it. And then
it's time to get another phone. With lots of spankin' new features.
I think I've said this before, but I remember the days when TV sets had
2 knobs: One for on/off/volume, and one for selecting channel (from
among maybe a dozen numbers at most). I mean, did you really need more
From: techwr-l-bounces+steve -dot- janoff2=teradata -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+steve -dot- janoff2=teradata -dot- com -at- lists -dot- techwr-l -dot- com]
On Behalf Of Robert Lauriston
Sent: Tuesday, November 03, 2009 10:39 AM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Narrative Technical Writing
How many users can figure out how to configure Facebook "Friend Lists"
and privacy settings so as to share different information with friends,
family, and professional contacts without consulting some extra-Facebook
documentation? How many can figure it out even then?
I just documented a purchasing application based on a subset of Oracle
Financials. I did write a one-page cheat sheet for end users, but it
took more like 25 pages to cover all the tasks four groups of users with
different privileges regularly have to perform.
On Tue, Nov 3, 2009 at 10:14 AM, Janoff, Steve
<Steve -dot- Janoff2 -at- teradata -dot- com> wrote:
> ... Web applications are becoming so easy to use, the eventual "help"
> might be a 1-page cheat sheet. ...
Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at: http://www.doctohelp.com/
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-