HTML Help: conventions for links

Subject: HTML Help: conventions for links
From: Leanne Tremblay <ltremblay -at- telus -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Sun, 25 Feb 2001 16:29:39 -0800


I am currently developing a style guide for an HTML help system. I am
looking for feedback and opinions on the consistent treatment of links.

For example:

For links embedded in procedures, I have seen "Tell me about XYZ" or
"How do I XYZ" on a separate line (indented no number) after the step.
In other cases, the link is part of the step.

If you have any comments on the following topics, I'd love to hear from

- Links embedded in procedures
- Links embedded in paragraph text
- Headings for links, such as Related Topics, Tell Me About...
- Lead-ins for links, such as "see XYZ"
- Locations for links (at the bottom or top of the topic, or embedded in
topic text)


Leanne Tremblay
Tech Pubs, Redback Networks

Develop HTML-Based Help with Macromedia Dreamweaver 4 ($100 STC Discount)
**WEST COAST LOCATIONS** San Jose (Mar 1-2), San Francisco (Apr 16-17) or 800-646-9989.

Sponsored by ForeFront, Inc., maker of ForeHelp Help authoring tools
for print, WinHelp, HTML Help, JavaHelp, and cross-platform InterHelp
See for more information and free evaluation downloads

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 for more resources and info.

Previous by Author: RE: Trademarks and nouns - how often?
Next by Author: UNIX Style Guide?
Previous by Thread: Collaberation with foreign company on projects
Next by Thread: Urgent Help Needed! - Word Doc not opening

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

Sponsored Ads