Re: how to list items
You mentioned not knowing the criteria, if any, used to determine the
interface order. You need to ask. If there is a logic to it (dependencies,
etc.), is that logic is meaningful or useful to the user, or is it based on
relationships that are internal to the code and only meaningful to the
If the interface uses a logical order that helps the user ("set the frammis
before choosing a widget"), then you should change the doc to match the
interface. If the interface order is random or not meaningful to the user,
then the programmer should change the interface to match your doc. :-)
Well, that's a wonderful idea. But it doesn't always fly. I use Netscape 7.1 as my mail and news client. The news groups are listed in the navigation pane in the sequence I subscribed to them. I could probably go digging in the registry or in some jsp file somewhere and change them to alphabetical order, but clearly that's not something you want to encourage users to do.
My point is that sometimes sequences just happen--as a result of an ill-considered architectural decision made early in the design process; and changing that logic to permit the developer or the tech writer to apply a more sensible sequencing rule may be fairly difficult as you get into the later stages of coding a product.
ROBOHELP FOR FRAMEMAKER AS LOW AS $299! Offer expires March 31.
Publish your FrameMaker documents online -- quickly and easily!
New licenses are only $899 for one and $499 for additional licenses.
Use a competitor's product? Switch to RoboHelp for FrameMaker
for only $299! Buy today: CALL 1-800-462-4420 or 1 858-847-7900.
Hurry, offer expires March 31 2004.
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
http://www.raycomm.com/techwhirl/ for more resources and info.
Search our Technical Writing Archives & Magazine