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.
> "Dick Margulis" <margulis -at- fiam -dot- net> writes:
>
>>Michael West wrote:
>>
>>>Maybe I'd get used to it if I spent enough time
>>>in it -- but I really shouldn't have to, should I?
>>>
>>Well, it's radical, I'll admit. But I'm basing it on Tufte's notion of
>>least perceptible difference, the minimalism of which appeals to me.
>>
>>
>
> But does it appeal to your users? Does the "minimalism" make it easier or
> harder
> for them to understand the material?
>
> It really doesn't matter whether or not you like it; does it meet the
needs
> of the user?
>
Stephen,
My approach to this topic has evolved. I used to have a key at the
beginning of a manual carefully explaining all the different
typographical conventions for menu items, buttons, code, yadayada. I was
meticulous in checking that I coded each element properly and put out as
nearly error-free a manual as I was capable of. And I am a good enough
designer that the pages looked okay, too. I have moved in stages,
though, to my present point of view that all that effort was not helping
the reader much, if at all--that mostly it was distracting.
With Web applications and with nearly all documentation being read on a
low-resolution device with poor typographic controls, I've come to see
that Tufte's approach is perfectly sensible. It is grounded, after all,
in psychology, not esthetics.
As nobody has yet complained to me, I'm confident that it works well enough.
Can I imagine types of documentation where that approach would not meet
the needs of the audience and bolding the names of the screen controls
would work better? Yes, I can. And many list members may be in such
situations. So I am not proposing that my current approach is the best
for everyone. I'm just saying it works for me now.
Dick
---
[This E-mail scanned for viruses at mail.fiam.net]
NEED TO PUBLISH FRAMEMAKER CONTENT ONLINE? "Mustang" is a NEW single
sourcing tool for FrameMaker that lets you easily publish your content
online. No macro language required! http://www.ehelp.com/techwr-l3
Mercer University's online MS Program in Technical Communication Management:
Preparing leaders of tomorrow's technical communication organizations today.
See www.mercer.edu/mstco or write George Hayhoe at hayhoe_g -at- mercer -dot- edu -dot-
---
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.