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.
Bevan Mccabe reports: <<A couple of these posters have mentioned surveying
your customers about numbered headings or fonts. I think this misses the
point of surveying. Such formatting-type questions are frivolous; a lot of
customers would skip these questions, and are a matter of opinion which
you're likely to get inconclusive results from in
any case.>>
Although you're correct that formatting questions are generally far less
important than knowledge-related and usability questions, you shouldn't
ignore such issues if you have time to do the research. Don't forget that
you don't always need to actually survey the customers; sometimes all you
need do is pick up a few standard references for that field. (For example,
if you're writing proposals or preparing manuscripts for peer-reviewed
journals, the client's guidelines will tell you exactly what their
requirements are.) In some fields, such as legal writing and military
documentation, the numbered headings are very important to readers, and
unilaterally deciding to eliminate numbering can end up decreasing
usability. I agree with the viewpoint that sometimes the user's expectations
are simply inefficient, and that we should make an effort to convert them to
something more efficient, but in practice, I don't know of any universally
applicable way to do this without causing more problems than we solve.
--Geoff Hart, FERIC, Pointe-Claire, Quebec
geoff-h -at- mtl -dot- feric -dot- ca
"User's advocate" online monthly at
www.raycomm.com/techwhirl/usersadvocate.html
"How are SF writers like technical writers? Well, we both write about the
things we imagine will happen in the future!"--Sue Gallagher
A landmark hotel, one of America's most beautiful cities, and
three and a half days of immersion in the state of the art:
IPCC 01, Oct. 24-27 in Santa Fe. http://ieeepcs.org/2001/
+++ Miramo -- Database/XML publishing automation. See us at +++
+++ Seybold SFO, Sept. 25-27, in the Adobe Partners Pavilion +++
+++ More info: http://www.axialinfo.comhttp://www.miramo.com +++
---
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.