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.
Let's assume we have a collapsing ToC--let's use WinHelp as the
example--with a number of multi-topic chapters. We also have quite a number
of single topic "chapters." For example:
WIDGETS
Widgets Overview
Making Widgets
-- At home
-- At work
Widget Disposal
Widget Uses
-- In Eating
-- In Bathing
-- In Recreation
Widgets in Space
Widget Variations
One school of thought is that the single-topic entries get folded up under
their own collapsing chapter heading. For example, Widget Disposal might
expand as follows:
Widget Disposal
-- Disposing Old Widgets
Another view is that standalone topics are standalone topics and don't get
collapsed, just as I presented in the first example, above.
What's the going opinion?
Second issue.
When I click on the main (chapter) entry in a collapsing ToC, should I
immediately see relevant info? Or should that click just expand the chapter
into its component topics without presenting anything new? Microsoft pretty
routinely does nothing but expand a chapter when you click the chapter
heading, leaving the previous topic's text onscreen. However, others (and
MS in some instances that I've seen), not only expand the chapter, but also
display some introductory info. In other words, whether you click a chapter
heading or a topic heading, you see some relevant text.
Again, what's the going opinion?
Thanks,
Sandra Charker
scharker -at- connectives -dot- com
+++++++++++++++++++++
We have enough Youth.
How about a Fountain of Smart.