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: hyperlink style question From:Scott Miller <scott_miller -at- CCMAIL -dot- COM> Date:Thu, 21 Aug 1997 11:57:51 -0800
Dilemma: The blue text, quotes, and page numbers seem like
overkill. Our audience is used to online stuff -- should we just
use the blue text and get rid of the quotation marks and page
numbers? (since they can just select the link and go to that
section) Or should I keep them in there for the one or two users
who might print the darn thing out?
Take out the page references. The online media is much more fragile and
unforgiving than print; stuff like useless page numbers just clogs the pipes and
gets in the way. Hardly any users ever print out an entire online document.
They occasionally print single topics, for which a page-number cross-ref is
Also: In-sentence hard jumps (jumps that close a topic and open another) should
be avoided. (In-sentence pop-up window jumps as in WinHelp are fine, if they
aren't over-used.) It takes more words to say "See Creating a process," but it
makes it very clear what the jump is to. If you say "you must first _create a
process_ in which the server application can run..." the user is not certain
what the jump is to. An overview topic? A procedure topic? A glossary
definition? If you say "See Creating a process," it's clear that this is
probably a procedure topic about creating a process.
Every time you provide a hard jump, you should conclude that the user will get
lost in hyperspace. You want to make sure that the user knows if he or she
needs to make the jump. A jump to a vague target is likely to get used by
people who don't really need to make that jump. Spelling out the topic title
lets them know exactly what they're jumping to, and they can better determine if
they want to make the jump.
Scott_Miller -at- ccmail -dot- com