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: Is it just me? S/W doc question From:"Wayne J. Douglass" <wayned -at- VERITY -dot- COM> Date:Thu, 29 May 1997 15:11:05 -0700
At 08:34 AM 5/30/97 +1200, Mark Jordan wrote:
>Part of problem, of course, is that the document is based largely around the
>user interface, and this is only a portion of the software developers arena.
>In addition the developer does not reliably think about changes and there
>affect on the UI and the user.
If you're like me and write about products that use a Web browser as part of
the user interface, then the problem can become more acute. It may be easy
for developers to meddle with a UI in any case, but it's even easier when
the display is HTML, which any fool can hack at.
The good news is that I can do it, too. Whenever I have found an aspect of
our sample forms that I don't like, I add a lesson to the tutorial on
customizing forms that explains how to modify them to my liking. The bad
news is that the developers have ripped off my ideas after reading a draft,
which forces me to modify the tutorial and recapture screen shots. It's a
game we play.
Verity, Inc. mailto: wayned -at- verity -dot- com
894 Ross Drive Telephone: 408-542-2139
Sunnyvale, CA 94089 Facsimile: 408-542-2040
Connecting People with Information: http://www.verity.com