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.
----- Original Message -----
From: "Anthony Markatos" <tonymar -at- hotmail -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Sent: Monday, March 13, 2000 12:59 PM
Subject: Re: Ideas in Motion
| Tony Markatos responds to Katie Kearns:
| Your class's experience is just further prof that written text is a
| very poor vehicle to use for documenting procedural information. To quote
| Ed Yourdon "Procedure is like dance - it defies written description."
| Ed means is that procedure is asychronous - multiple things happening at
| same time and multi-decision branching. Text is very poor at describing
And yet people have been using text-only procedures quite successfully for
years and years.
It isn't that the text is poor in some situations, it may be that the writer
isn't in the same mind-set as the user.
Flow-chart graphics may only further confuse and frustrate the user. You
not only need to know
WHAT the procedure will do, but WHY the user would need to do it.