Help describing fields.

Subject: Help describing fields.
From: Stanley Smith <smith -at- tdk -dot- dk>
To: "'techwr-l -at- lists -dot- raycomm -dot- com'" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 8 Mar 2000 10:31:15 +0100

Hi Techwr-lers,

I am working on a user guide for a complex software application being
developed for use by telecommunications companies.
The product has many different screens that they are calling Forms. Each
Form has a different function and has many different data input fields that
need to be described.
But the description of some of the fields is quite obvious and can be
discerned from the field title. Since the system is so complex, each Form
field that will be described in the user guide must have some text either
descibing the use of the field or indicating the data type to input into the
field. Still, some field descriptions are self explanatory as they appear at
many instances throughout the system eg. description, country name,
international ID etc.

For consistency, what I suggest is to use a generic text to as the
desciption of these field types. Some have come up, but in my opinion these
sound a bit condescending to the user.


Can you suggest a better way to handle this situation?
Any comments or suggestions would be greatly appreciated. Thanks in advance.



Stan Smith
Technical Writer
Tele Danmark IT * Teglholmsgade 1 B-337 * DK-0900 København C
E-mail: smith -at- tdk -dot- dk * Phone: + 45 33 83 44 36 * Fax: + 45 33 20 17 01

When all else fails, read the manual. If that doesn't work, do what it says.

Previous by Author: Re: TW's and QA managers
Next by Author: Sites like Guru
Previous by Thread: Summary of responses on HATs
Next by Thread: Re: Help describing fields.

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

Sponsored Ads

Sponsored Ads