Re: Checking code (was: Software engineer tech. writers? )

["Gene Kim-Eng" <techwr -at- genek -dot- com>]

What Carla idescribed is consistency, not usability.
Keeping products internally consistent is certainly part
of good usability design, but only a small part.  Asking
users what they want is also a part, but again only a
part, because many users haven't the foggiest idea what
makes a design "usable" for them, much less what will
make it so for a majority of targeted users other than
themselves.  Outside of the software design silo, 
usability is called "Human Factors," and is yet another
field that technical writers cannot just hop into after
spending a night at a Holiday Inn Express.

Gene Kim-Eng


----- Original Message ----- 
From: "Chris Borokowski" <athloi -at- yahoo -dot- com>
> One of the reasons I think technical writers should branch out into
> usability is that such things often go unnoticed, and fixing them is a
> skill that directly relates to the skillset of communicating with
> users. Users need consistency, not "creativity" in randomly naming
> buttons, commands, and so on. I see inconsistency quite a bit, and most
> of my comments returned to engineers are fixes in that area.
> 
> --- "Martinek, Carla" <CMartinek -at- zebra -dot- com> wrote:
> 
>> Years ago I was documenting a program for a mobile radio computer. 
>> As I
>> went through the program, I started noticing that the buttons used
>> for
>> various functions (think DOS application screens) varied from screen
>> to
>> screen.  For example, Print might be F6 on one screen, but F8 on
>> another, and so on. 

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or 
printed documentation. Features include support for Windows Vista & 2007 
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot- 

To unsubscribe send a blank email to 
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/ for more resources and info.