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.
Re: Grammar and rhetoric, is that all there is to it?
Subject:Re: Grammar and rhetoric, is that all there is to it? From:Marguerite Krupp <mkrupp -at- CAYMAN -dot- COM> Date:Mon, 6 Jun 1994 13:15:53 -0400
Having done tech writing, course development, and stand-up teaching, I'm
throwing my two-cents' worth in:
Teachers and course developers would serve users better if the courses
taught people how to use the manuals to find the info they're likely to
need when they get back to East Overshoe. Courses need to have exercises
to allow learners to practice their skills. Part of the exercise should be
looking things up in the manual and/or using the online help.
Good tutorials are wonderful learning tools. They accelerate the learning
process. A course that does not teach how to use all of the tools
available, including the documentation, is not doing the full job.
I get totally exasperated when I hear a trainer discouraging people from
using the manuals. "Don't bother looking at the manuals; everything you
need is in your workbook" (or worse). It's a setup for expensive support
calls and user frustration. Did you ever try to find reference information
in your workbook after you finished the course? You want a specific piece
of information, and you have to wade through pages of explanation. It's a
matter of using the right tool for the job!
OK, that's it. We now return you to your regularly scheduled program. <g>
Marguerite
------------------------------------------------------------------------
"All jobs are temporary, but some come with benefits." - John Garrison