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:One document for both training and reference From:David Fisher <DAF -dot- DSKPO27B -at- DSKBGW1 -dot- ITG -dot- TI -dot- COM> Date:Mon, 15 Jan 1996 08:30:11 CST
Julie Tollefson wrote:
>Our technical writing department has been asked to investigate the
>possibility of producing one document that meets training and reference
>needs. By doing this, we would be able to eliminate duplication of effort
>between our department and our training department. We would like to know
>whether others have taken this approach and, if so, whether they feel it has
>been successful. If it has been successful, how have they measured that
>success? Any information or anecdotes you can provide would be appreciated.
I attended a course called One-stop Documentation that discussed that very
topic. It was offered through the Ziff Institute by the Gottfredson Group. I'll
quote the introduction to let you know what it was all about.
"Upon completion of this seminar, you will walk away with a unique but
powerful view of the role computer documentation can and
should play in the workplace. Specifically, you will learn how the write one
that will serve as reference guide, tutorial, and student manual for
classroom training -- its called One-Stop Documentation!"
This sounds like what you were asking for. We don't use this technique in our
group, but other groups in the company have used it with success.
The address and phone number to contact Dr. Gottfredson are:
The Gottfredson Group
5935 Westfield Rd
Alpine, Utah 84004
Hope this helps,
dfisher2 -at- ti -dot- com
"The opinions expressed herein are mine, all mine."