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.
Sulbha Bahl wondered: <<I was recently asked by the QA dept if there
was a rule to define the maximum size of a dialog box? And that would
work for all environments.?>>
There is no absolute rule, and certainly not one that would apply to
"all environments"; every environment differs, and information-heavy
dialogs must obviously be larger than simple dialogs. Most office
workers, for instance, will be using 17-inch or larger monitors,
whereas laptop users will rarely be using anything larger than 15-
inch wide screens and CAD engineers are unlikely to be using anything
smaller than 24 inches. Fill the screen with as much detailed
information as a CAD engineer needs and the office worker and laptop
user will curse your name. Ditto for the CAD user if you create 5000
tiny dialogs just to make your office workers stop cursing. <g>
Some audience analysis would help. For instance, if you know that
your audience consists only of the CAD workers, and that the product
requirements specify a minimum 24-inch screen at a resolution of X by
Y, then you can safely treat that as your maximum size. But if you
don't know who will be using the software, you need to think more in
terms of "lowest common denominator". That's likely to be the smaller
of the two dimensions (both horizontally and vertically) for the 17-
inch monitor/15-inch laptop that represent the smallest screens in
your audience. You can also design for the needs of 80% of your users
and ignore the remaining 20%, but why piss off 20% of your audience
if you don't have to?
<<Some of our dialog boxes are so big that on some machines (Unix/
Linux), the users can't see the entire dialog box. These are not
resizable either.>>
That's simply bad design. Among other things, I'll bet that the same
people who "designed" (to misuse a word) these dialogs didn't spend
any time arranging their contents logically either. You need an
information designer who can show you how to reorganize information
logically. Tabbed interfaces, with "Advanced..." buttons to reveal
the less commonly used features on each tab, are a good solution.
Check out how InDesign and Word implement this and you'll see a good
solution.
You might also be interested in an article I wrote about this
(unfortunately not available on my Web site, though it's been long
enough I should ask the publisher for permission):
Hart, G.J.S. 2003. Redesigning to make better use of screen real
estate. Pages 337–350 in M.J. Albers and B. Mazur, editors. Content
and complexity: information design in technical communication.
Lawrence Erlbaum Associates, Mahwah, NJ. 368 p.
----------------------------------------------------
-- Geoff Hart
ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com
www.geoff-hart.com
--------------------------------------------------
***Now available*** _Effective onscreen editing_
(http://www.geoff-hart.com/home/onscreen-book.htm)
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-