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:Procedural tables From:geoff-h -at- MTL -dot- FERIC -dot- CA Date:Fri, 31 Jan 1997 13:22:40 -0600
Heidi Margenau proposed a problem involving excessive
numbers of procedural tables; the alternative was burying
the details in some form of paragraph.
Two questions: First, could you provide an example? It's
easy to do procedures without resorting to either buried
paragraphs or long tables, but it helps to have something
concrete to work with. Second, are you sure the tables
really do pose a problem? If you haven't checked with your
users, don't jump to any conclusions. One of my colleagues
converted her company's manuals to use almost exclusively
procedural tables and, in addition to drastically reducing
the size of the documentation, produced something that
users were considerably happier with. (And incidentally,
she won an STC award for the result.)
--Geoff Hart @8^{)} geoff-h -at- mtl -dot- feric -dot- ca
Disclaimer: Speaking for myself, not FERIC.
TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html