Heuristic evaluation of documentation?

Subject: Heuristic evaluation of documentation?
From: "Hart, Geoff" <Geoff-H -at- MTL -dot- FERIC -dot- CA>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 6 Oct 2003 11:00:19 -0400


Robert Plamondon reports: <<When I see the word "heuristics," its usage
rarely matches any of its dictionary definitions. From context, it seems to
be a sissy way of saying "rules of thumb." Or am I missing something?>>

You're missing something--and smile when you call us a collective "sissy".
<g> See, for example, http://www.hyperdictionary.com/dictionary/heuristic

Typically, the meaning is along the lines of a following a series of
guidelines (something like working through the steps of a computer
algorithm) in an attempt to solve a problem. In terms of documentation, the
problem is "avoiding common errors or following recommended practices". This
term has acquired the connotation that the guidelines are "proven" (by
research) or otherwise represent "best practices"--neither of which is
necessarily the case--and that by using the guidelines as a checklist,
you'll end up with a better result than if you worked by the seat of your
pants.

--Geoff Hart, geoff-h -at- mtl -dot- feric -dot- ca
(try ghart -at- videotron -dot- ca if you get no response)
Forest Engineering Research Institute of Canada
580 boul. St-Jean
Pointe-Claire, Que., H9R 3J9 Canada

Vah! Denuone Latine loquebar? Me ineptum. Interdum modo elabitur. (Oh! Was I
speaking Latin again? Silly me. Sometimes it just sort of slips
out.)--Anonymous

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

NEED TO PUBLISH YOUR FRAMEMAKER CONTENT ONLINE?

RoboHelp for FrameMaker is a NEW online publishing tool for FrameMaker that
lets you easily single-source content to online Help, intranet, and Web.
The interface is designed for FrameMaker users, so there is little or no
learning curve and no macro language required! Call 800-718-4407 for
competitive pricing or view a live demo at: http://www.ehelp.com/techwr-l3

---
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.



Follow-Ups:

Previous by Author: Estimation of timelines for documentation projects?
Next by Author: Heuristic evaluation of documentation? (Take II)
Previous by Thread: RE: Heuristic evaluation of documentation?
Next by Thread: RE: Heuristic evaluation of documentation?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads