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.
Subject:Re: Writing for on-line From:"Bergen, Jane" <janeb -at- ANSWERSOFT -dot- COM> Date:Wed, 18 Feb 1998 12:51:42 -0600
On Wednesday, February 18, 1998 11:39 AM, Wing, Michael J
[SMTP:mjwing -at- INGR -dot- COM] wrote:
> > Readers may not read a printed manual from front to back, but the
> > does have a "flow" that online does not have. For example, most
> > Jane
> I lost track here. Are we comparing online help, online documents, or
> to the printed document? If it is online help, I wouldn't expect to
> from front-to-back. Instead, I expect to press the "?" icon or F1 and
Yeah, I think you did lose track. Maybe I wasn't clear, either.
The thread here was how much difference is there in the way
users/readers approach printed docs versus online docs. I was responding
to someone who said "not much....ALL technical readers read in snippets
or chunks, not front to back in printed docs.... so a writer can use the
same information/arrangement/text/etc. for both" (A loose paraphrase)
My response was that readers use printed documentation differently than
they do online. While it's true they don't read printed docs from front
to back, they still have a different set of expectations and
requirements that they bring to the printed form.
I won't repeat the whole thing....just wanted to clarify. I'm glad to
see this discussion as I think too many technical writers don't have a
clue about readability/usability issues or audience needs (and yes, I
can elaborate on that statement, too).
Jane Bergen, Technical Writer,
AnswerSoft, Inc. Richardson, TX
janeb -at- answersoft -dot- com