Re: Tables of Figures and Tables -- useful?

Subject: Re: Tables of Figures and Tables -- useful?
From: "Peter Neilson" <neilson -at- windstream -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 29 Aug 2013 16:56:22 -0400

Those things used to be part of printed docs. Viewing docs on a screen they are indeed clutter, especially if you can't click from the TOC directly into the paragraph you need. You can almost always search for what you need. An introductory paragraph often serves a better purpose than a TOC. Table of figures are IMHO useless.

On Thu, 29 Aug 2013 16:36:16 -0400, Rick Stone <rstone75 -at- kc -dot- rr -dot- com> wrote:

Speaking as a documentation consumer, other than being able to ask a support person about item 2 in table 23-1, I've always wondered about what helpful purpose is served to the reader by having and numbering these.

On 8/29/2013 3:24 PM, Matt Gras wrote:
I'm helping a smallish engineering company upgrade its documentation. It's been a battle persuading them to include a TOC in their reference guides -- and now they're balking at including tables of figures and tables. I'm wondering if they might be right -- that these lists add more clutter than useful info.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Previous by Author: Re: Is your company's doc team responsible for writing documents for audit purposes?
Next by Author: Punctuation in quotes -- American style
Previous by Thread: RE: Structured FrameMaker Master Pages
Next by Thread: TechWhirl: Technical Communication Recap for August 30


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads