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: Do Users Refer to a Table of Figures? From:Karen Field <kfield -at- STELLCOM -dot- com> To:TECHWR-L <techwr-l -at- lists -dot- raycomm -dot- com> Date:Tue, 7 Mar 2000 16:02:50 -0800
<<My experience suggests that a good index and table of contents are far
more
useful, and that for most users, a table of figures is just a waste of trees
and bytes.>>
Connie,
I agree completely. I can't image a user looking up a figure in a table of
figures. If they had questions about a dialog box, for example, they'd
probably look up the dialog box name in the index, where there might
subentries for the d-box such as "explained" or "using to print files" or
whatever.
Another point: If you tag every occurrence of the same figure in a table of
figures, the user sees that figure more than once, with no supporting
information. Which one should they go to first? This is a clear example of
how a good index can replace the arcane practice of listing figures.
Karen Field
Sr. Technical Writer
Stellcom, Inc.
San Diego, CA