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: TW and grad school -Reply From:Karen Kay <karen -at- WORDWRITE -dot- COM> Date:Wed, 11 Feb 1998 22:46:44 -0800
Barb Philbrick said:
> It's not just formatting. It's also organization.
> Online help is excellent for brief procedures for software. It's
> horrible for conceptual or theoretical information and for hardware
But the paragraph you quoted below is about online doc, not online
help: two different animals.
> >The real problem as I see it--and maybe this is what people were trying
> >to say--is formatting. The problem is not fundamentally content,
> >audience, or anything else. Formatting that looks good in a book is
> >rarely best for online viewing, searching, etc.--or vice versa. Since
> >the vast majority of word processors, desktop publishing programs, and
> >markup languages embed formatting information in the text itself, rather
> >than embedding references to the text within the formatting information
> >(which would allow you to modify one copy of the text while maintaining
> >two different sets of formatting information), this is a problem for
> >which I see no short-term resolution.
> Barbara Philbrick, Caslon Services Inc.
> Technical Writing. caslonsvcs -at- ibm -dot- net
> Cleveland, OH