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: why not an engaging style? From:mlist -at- safenet-inc -dot- com To:"TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Mon, 22 Aug 2005 13:33:22 -0400
David Neeley said a bunch of sensible stuff including:
> This has been a very popular approach among these new users. By using
> a general approach similar to the Information Mapping structure for
> procedural information (an introductory bit telling what the section
> will accomplish, the individual steps clearly set out, and a final
> discussion giving more overview and any reference information that
> might be helpful), working through a tutorial becomes a self-guided
> experience that instructs very effectively, while also serving as an
> easy to use reference later when they may have forgotten one procedure
> or another.
Information Mapping, information schmapping.
In the 60s, a crusty army sergeant instructed a bunch of (us)
army cadets and militia/reservists on how to give a presentation
or a class. His summary, which sticks with me, was:
"Tell 'em what you're going to tell 'em.
Tell 'em.
Tell 'em what you've told 'em."
Hasn't let me down in [my gosh that's a lotta] years.
Kevin
The information contained in this electronic mail transmission may be privileged and confidential, and therefore, protected from disclosure. If you have received this communication in error, please notify us immediately by replying to this message and deleting it from your computer without copying or disclosing it.
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.