How to document column names?

Subject: How to document column names?
From: "Allen, Emily" <emily -dot- allen -at- teldta -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 11 Jun 2004 13:26:50 -0500


I'm working on some on-line procedural documentation for a GUI and one of
the columns that I need to reference has a name that does not at all
represent what is displayed in that field. Any suggestions/standards as to
how to document this?

I have chose to use the name that the GUI displays and then included a note
informing the user what the column represents. Is this going to cause users
anxiety when looking at the documentation? Am I going to be confusing them?
Again, this is a battle between the Documentation Specialist and the

Thanks for your input.

Emily Allen | Documentation Specialist
Telephone and Data Systems, Inc.
8401 Greenway Blvd | Suite 230 | Middleton, WI 53562
T: 608.664.8249
emily -dot- allen -at- teldta -dot- com |


SEE THE ALL NEW ROBOHELP X5 IN ACTION: RoboHelp X5 is a giant leap forward
in Help authoring technology, featuring Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more!

>From a single set of Word documents, create online Help and printed
documentation with ComponentOne Doc-To-Help 7 Professional, a new yearly
subscription service offering free updates and upgrades, support, and more.

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- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.


Previous by Author: Field definitions
Next by Author: Re: Noise abatement (was RE: ADD/ADHD Problems and Tech Writing/Editing Careers
Previous by Thread: Frame - Books + Training - Recommendations
Next by Thread: How to document column names?

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

Sponsored Ads