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:Elements in a Tech Reference Manual From:"Nancy E. Kaminski" <nancykam -at- MEDIAONE -dot- NET> Date:Thu, 5 Aug 1999 11:21:43 -0500
I've just been given the task of writing a technical reference manual for an
application. The system is a GUI interface that displays patient and lab
result information that resides on a mainframe. Basically, it's the pretty,
easy-to-use program that caregivers use to get read-only patient
information; the actual info is entered via several different mainframe
applications at our hospitals.
I've always written end-user manuals; this is a first for me. What basic
elements should be in such a reference? In the meeting today we discussed
having sections on system architecture, troubleshooting, how the database is
organized, and something called "push printing" (which I'll learn about next
week). The development team doesn't really know what else they may want, and
I'm supposed to come up with a list.
Any suggestions of what the typical structure of this type of book is would
be welcome!
Thanks!
===============================================
Nancy E. Kaminski , Technical Writer/Editor
Fairview Health Services, Minneapolis, MN USA
(612) 672-6882 phone, (612) 672-6083 fax
nkamins1 -at- fairview -dot- org | nancykam -at- mediaone -dot- net
"Time is an illusion, lunchtime doubly so." -- Douglas Adams
===============================================