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.
I think the write/implement approach is very good, but it would be
better to try a procedure that the implementers have never done or
seen before. It's much to easy for them to assume procedures or
information if they are trying to implement something that's very easy
and familiar. What about having the writers document a new game
(doesn't necessarily have to be even a computer game...could be
backgammon or a card game) or a shareware program? Make it more
"real-life" for the implementers. It might also be more challenging
for the writers.
> I use another PB&J activity with my beginning technical writing
students. I assign half the class to write procedures for the sandwich
making process and the other half of the class has to implement the
process. It's a great hour's worth of hilarity!
>
> Marj Hermansen-Eldard
> ZZSoft, Inc.
> Senior Technical Writer
> meldard -at- zzsoft -dot- com
