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.
>In my previous job, we included a series of APIs that allowed
>programmers to seemlessly work our product into their product. Our goal
>was to do away with the paper documentation and replace it with an
>HTML-based online solution. I watched how our programmers worked and saw
>that they rarely cracked a manual. Instead they used the online help
>that was integrated into their development tools. They said that the
>design of the tool made the online information more useful than paper.
And in that context, I agree that online reference information is often the
best solution. It's what I create at my current job, for exactly that reason.
>So if your goal is to get Aunt Martha up and running on her Windows '95
>computer, a big old bunch of paper documentation probably isn't a bad
>thing. But not everyone is Aunt Martha.
And not everyone who prefers paper documentation is a brand-new naive user.
Some folks still prefer to learn in the linear style of a traditional
user's guide, with all of the conceptual information and examples that are
often missing in online help these days.
And some people really *are* Aunt Martha :)
martha, happy to be the aunt of Adi, Leeav, and Eliott
--
Martha Jane {Kolman | Davidson} mailto:editrix -at- slip -dot- net
"If I am not for myself, who will be for me?
If I am only for myself, what am I?
If not now, when?"
--Hillel, "Mishna, Sayings of the Fathers 1:13"