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.
Thank you. Very much for jogging my thinker. I believe I have a solution that will work and I feel better about. If I went with the exercise table, I'll basically be telling the users the same thing three times, video, steps overview, and exercise. I don't think I need to do it that way. Thank you very much.
Ginger Stuckey
Technical Writer
CB&A Project Management Services, LLC
Assigned to Southern Company Technical Publications
205-992-5651
-----Original Message-----
From: Weissman, Jessica R [mailto:WeissmanJR -at- state -dot- gov]
Sent: Wednesday, April 19, 2017 2:00 PM
To: Stuckey, Ginger <X2BVSHEW -at- SOUTHERNCO -dot- COM>; TechWR-L (techwr-l -at- lists -dot- techwr-l -dot- com) <techwr-l -at- lists -dot- techwr-l -dot- com>
Subject: RE: Training Document Wishy-Washiness
Don't duplicated information needlessly. There may be a better way than having two columns with most of the Action column entries blank, but if you duplicate information the distinction won't be easily understood and users may be lulled into thinking the actions are just steps - thus missing the important entries in the Actions column.
Are the actions-that-are-not-steps all prerequisites that should be in place before the steps start? Or is there some other way to reduce the confusion?
Jessica Weissman
Senior Technical Writer
ValidaTek, Inc.
Personal
UNCLASSIFIED
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com