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.
I would eliminate the colon unless it appears on the screen, and then I
would bold it.
From: Chuck [mailto:writer -at- best -dot- com]
Sent: Tuesday, October 05, 1999 12:07 PM
Subject: bold the colon?
This is probably a style issues, as in "do whatever your company's style
is," but this is a new company, I'm the only tech writer, and there is no
style guide. The question:
In reference documentation, documenting the various UI elements on screen, I
create lists such as
Widget1: Widget1 description.
Widget2: Widget2 description.
Widget3: Widget3 description.
and so on......
I apply bold to "Widget1" and "Widget2." Should I apply bold to the colon as
Note: Normally I wouldn't produce documentation fomratted this way,
preferring to use more fine-grained context-sensitive Help. It's not an
option here though, where my only practical option is to produce
higher-level HTML files.
I hope this doesn't turn into another holy war. <g>
writer -at- best -dot- com
Sponsored by Weisner Associates Inc., Online Information Services
Moving your documentation online? We can help with standards, planning,
or training. Visit us at http://www.weisner.com or mailto:info -at- weisner -dot- com -dot-
Sponsored by DigiPub Solutions Corp. Make your team FrameMaker experts with
our Power User training for Adobe Acrobat and FrameMaker. Delivered at your
U.S. site or ours. http://www.digipubcorp.com, mailto:trainme -at- digipubcorp -dot- com
You are currently subscribed to techwr-l as: David -dot- Wollenberger -at- STERLING -dot- COM
To unsubscribe send a blank email to $subst('Email.Unsub')
Send administrative questions to ejray -at- raycomm -dot- com -dot-