RE: Heuristic evaluation of documentation?

Subject: RE: Heuristic evaluation of documentation?
From: "David Locke" <dlocke -at- texas -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 6 Oct 2003 19:09:23 -0500


In AI, a heuristic is a score generated by a mathematical function. That
score evaluates a the situation in a solution space and attempts to provide
guidance for the next step, so that the ultimate goal is reached. A
heuristic is not a generative rule. It is not a process, nor practice. It is
the result of an evaluation of a pattern.

In chess, you have a heuristic that says control the center of the board. If
your opponent moves either of his rook pawns first, then they are at a
disadvantage relative to this heuristic. There may be another heuristic at
play with that move. The problem is that there are tons of heuristics and
they are specific to one approach where another approach would come with its
own collection of heuristics. For chess masters, there is no one correct
way, but there are specific approaches that resolve another approach.

If you haven't taught your writers a collection of approaches, they will
bring their own to the table and a mess will ensue. That mess may be fine,
because each writer is optimizing the production in their view. There are
lots of metrics. Just pick up five different books on writing user manuals.
They won't agree. And, each will contain a collection of approaches. Mastery
is selecting, from all those approaches, an approach. In a departmental
context the next step would be embedding the selected approaches in a style
guide, and subsequently enforcing those approaches as editorial standards.

David Locke


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

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.



References:
Re: Heuristic evaluation of documentation?: From: Dawn Whitlock

Previous by Author: RE: PDF a "book" of Word files
Next by Author: RE: Résumé help
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