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.
I've got an issue, and I'm just not sure of the best way to resolve it. My
original hunch is contrary to one our tech support persons, so I come to you
to get your opinion.
I have a diagram that shows how to connect our instrument to a panel at
the customer's site. There are six connections in various places; they
happen to fall in two columns of three connections. I'm trying to determine
the best way to order the reference letters. I'll try to show you visually
Example 1 - ordering the reference letters in alphabetical format.
o A o D
o B o E
o C o F
Pro-easy for the user to see a pattern in the lettering
Con-the user would connect A, then D, then F, then B, then E, then C (out of
Example 2 - ordering the reference letters in order that the user will have
to make the connections.
o A o B
o D o F
o E o C
Pro-the user would connect in alphabetical order (A, then B, then C...)
Con-the user might have to 'hunt' in the diagram to find where the correct
Does this query make sense? I hope I explained it ok. Anyway... does any
have a thought as to which Example would be easier for a user to follow?
Freedom, CA, USA