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.
Despite a number of "more acceptable" alternatives, a 'quasi' Dilbert
situation has arised.
Originally, I was questioned about the acceptabilityof a single item in a
billing system GUI for mobile telephony, which was part of a complete
customer profile.
The item: Not overdue amount belonged to the "Payment Record" section of the
GUI consisting of three main elements
as mentioned in the original posting:
<Total unpaid amount>
<Not overdue amount>
<Overdue amount>
When limited to the two versions presented in the original posting, Version
2 was clearly preferred over Version 1. To refresh those jumping on board:
The Comments fell more or less into two camps: "If i have to choose one of
two lesser evils, then Version 2, but..." versus "Well, you know ..how
about Version 3.." Also, a number of you pointed out the awkwardness of
both, how neither one of the two represented no 'up-to-date' standard used
by accountants or found in credit card bills, telephone bills, etc. Browse
the comments for the reactions: (contributors know their voice)
Version 2 as 'acceptable'
"I like Version 2...it was quicker for me to understand (I see what you mean
about "not overdue amount"...that does sound awkward. I like better "amount
not overdue" better, if forced between a choice of the two."
"i'd go for version 2, since it maintains parallel heading structure of the
3 fields"
"I vote for version 2 of the first line. 'Amount not
overdue' is less convoluted. As for the second line
the two versions seem about equal to me."
There's got to be a better way
"see if there's something equivalent to: Current Amount Due. It's
not overdue, but it is due. That's typically how I see items such as this
on invoices."
"Adding 'amount' to each label seems to clutter things up without providing
extra information. If you like, you can add dollar signs or other currency
marks to each amount."
"can I ask a really stupid question, being a TW, i'm known for them, what is
'not overdue' here? Are you trying to say 'amount up to present time'?"
"What we have here," I said to my accounting-degreed self, "is a genuine,
bonafide aging report." From the murky depths of my previous career as a
number-cruncher, I offer the following suggestions; however, they may not be
feasible for localization:
...both were a little confusing. I did not quite get the part that said
"amt. not overdue" (i.e., it took me a while to think about).
Some Alternatives included:
a. Total (Outstanding) Balance: Current: Past due
b. Total unpaid Not overdue Overdue
c. Unpaid Balance Current Amount Due Previous Balance
d. Balance Due Current Balance Past Due
e. Total Due Current Charges Overdue
Current
Mainly the repetition of the word, 'amount' through-out and the plainly
stilted, 'not overdue amount' were the problem areas.
What purpose does "amount" serve when the numbers say it all? or What does
'not overdue amount' actually mean, at all??
Dilbert takes the cake and the winner is:
Billed unpaid amount Billed not overdue
273.58 85,60
Billed Overdue
1-30days 31-60 days
120,53 67,45
This decision was prefaced with having been made before reading the
responses received from the newsgroup, i.e. "It's not so important to me,
afterall and I've made my decision and got better things to do with my
time". The rationale behind "Billed" was to indicate that this was the
amount "billed", but not necessarily "charged". Some customers receive
credits, and hence do not pay the fully "billed" amount. But, IMHO, the
repetition of "billed" becomes superfluous against the other two entries and
leads to inconsistencies in its use. Does this mean "Billed Overdue" is not
necessarily charged either???
Well, in short, I want to only thank again those who responded in the list
and off-line. Your contributions only confirmed some already apparent
dilemnas with the terminology at hand, but it really isn't my job at the
moment. (So much for doing favors) But for the sake of argument and
exchange, it was a good show. If your still scratching your head and saying
"Huh??!!" , then ask away...otherwise cheers.....
stay posted
--Alan
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Develop HTML-based Help with Macromedia Dreamweaver! (STC Discount.)
**NEW DATE/LOCATION!** January 16-17, 2001, New York, NY. http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.
Take XML and Tech Writing courses online! Our instructor-led courses
(4-6 hrs/wk) give you "hands on" experience at your convenience. STC members
get 20% off! http://www.online-learning.com/index.html.
---
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 http://www.raycomm.com/techwhirl/ for more resources and info.