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.
If your functions are listed alphabetically, as God intended, the issue
largely goes away. The overloaded functions will be either presented as
independent functions, one after the other, or you can have a single entry
and list the variants under it. The reader turns to the same page to begin
with in either case.
If they all have individual entries, then each one should have a "See Also"
cross-reference to the others.
Which to choose depends on how much they have in common and how long the
descriptions are. For example, if there are four almost-identical instances
and they can all be disposed of in a single page, they obviously should be.
If they occupy ten pages each, I'd probably keep them separate. If even one
instance was unrelated to the others, I'd probably list each of them
separately, and not have some grouped and some independent, because I want
the structure of the document to be obvious to the reader.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Last chance to order RoboHelp X3 and receive a $100 mail-in rebate,
PLUS free RoboScreenCapture and WebHelp Merge Module. Offer expires
4/30/03! Order here: http://www.ehelp.com/techwr-l
Help celebrate TECHWR-L's 10th Anniversary starting this month!
Check out the contests at http://www.raycomm.com/techwhirl/special/contests/
Happy birthday to you, happy birthday to you, happy birthday TECHWR-L....
---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.
