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:2nd Try: Need style advice on lists in tables From:"Judith Plummer" <jeplum -at- patriot -dot- net> To:"TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Mon, 7 Mar 2005 22:37:43 -0500
Well, posting a message with typos in the subject line isn't very good for
an editor (even a very tired editor). Mea culpa! Let's try that again.
Hello Techwhirlers -
I'm back on this list after several years' absence, and I would really
appreciate help with an issue my editing group is working on currently.
In our books, we often have situations where various options for a field
value are explained within a table description. If this list were in body
text, out style would be to use bolded run-in heads, followed by a period
and then a Roman-font explanation. However, in tables we don't want to use
bold at all. However run-in heads with no special treatment don't stand out:
For example (I'm rendering this table as best I can in plain text):
Field Description
____________________________________________________________________________
Secret Question The question used to identify you if you have
forgotten your password or
user ID. Valid values include:
* Mother's Maiden Name. This
lastname your mother used before
she was
married.
* Childhood Pet. The name of the
dog, cat, or other pet you had
as a child.
____________________________________________________________________________
I'd like to hear what styles others use in this situation. If you can't use
bold for the material before the period, then would you use italic, for
example, or how would you handle such a situation?
BTW, this is an accepted style for my doc department, and it's not going to
go away, so I'm not as concerned about whether or not there should even be a
list inside a table--they are there, and I have to deal with them as such.
Thanks! :)
Judith Plummer
Senior Technical Editor
jeplum -at- patriot -dot- net
Herndon, VA
WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo: http://www.webworks.com/techwr-l
Doc-To-Help 7.5 Professional: New version with new features, improved performance and reliability, plus much more! Download your free trial today at www.componentone.com/techwrlfeb.
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.