Re: Language check list?

Subject: Re: Language check list?
From: "Brad Jensen" <brad -at- elstore -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 21 Jan 2002 09:46:53 -0600


----- Original Message -----
From: "Hart, Geoff" <Geoff-H -at- MTL -dot- FERIC -dot- CA>
> Convince the programmers to let _you_ write the error messages,
or at least
> to let you edit the messages before they're incorporated in the
user
> interface. The first case assumes that they have the time to sit
down with
> you, explain a problem, and work with you to come up with a good
solution;
> it's an ideal way to work, but not one you can always do because
of time
> constraints. (Some programmers who have particular problems with
writing do
> like it because it's faster than if they had to write the
message
> themselves.)

If you can write a one page or two page do's and don'ts list, get
each programmer to read it and sign it, you will prevent a lot of
the problem in the first place.

> The second case is much easier: the programmers either e-mail
you the
> message so you can edit it and return it via e-mail, or they
give you a file
> (in Delphi, it's called the "language" file according to my pet
programmers,
> and there are surely equivalents for other languages) that you
can edit
> directly in a text editor.

This idea is okay, provided that the programmers get a final say
on anything you edit. You had better review it with them before
you send the software out, and not after the angry customers storm
the marketing department.

> Usually, this also lets you edit user-interface
> terms at the same time (menu names, field labels, etc.).

You do that and you will have crosses burning in your front yard.

Speaking with my programmer hat on, the user interface is not
something that should be edited outside the programming
environment, unless the program was designed that way (we do with
some of our programs, to make them multilingual).

You edit the word or phrase, and it suddenly doesn't fit any more,
the user sees half of it. Or you make it shorter, and now the user
isn't sure what data entry field it refers to. Or you change the
name of a field that is called one thing on 245 other programs,
but is now labelled differently on this screen.

Or maybe you edit for style, not realizing that the term being
used is a well-known and expected one in the industry, say grocery
supply companies.

I do think most programmers could benefit from having a style to
work from.

Web interfaces are more flexible,if they resolve to html.

Brad Jensen



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Collect Royalties, Not Rejection Letters! Tell us your rejection story when you
submit your manuscript to iUniverse Nov. 6 -Dec. 15 and get five free copies of
your book. What are you waiting for? http://www.iuniverse.com/media/techwr

Have you looked at the new content on TECHWR-L lately?
See http://www.raycomm.com/techwhirl/ and check it out.

---
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.


References:
Language check list?: From: Hart, Geoff

Previous by Author: Re: Reality check
Next by Author: Re: Speaker's Notes in PowerPoint
Previous by Thread: Language check list?
Next by Thread: Should Tech Writers do Field Studies?


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

Sponsored Ads


Sponsored Ads