131 lines
5.5 KiB
HTML
131 lines
5.5 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: man/info debate -->
|
|
<!--X-From-R13: Bngevpx Qnyynuna <cnp1Ngvnp.arg> -->
|
|
<!--X-Date: Wed, 13 Sep 2000 23:07:54 -0400 (EDT) -->
|
|
<!--X-Message-Id: 39C04167.116D543E@tiac.net -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: 20000827010903.A12937@alpha.bruce -->
|
|
<!--X-Reference: 39A951B8.65AA2A79@tiac.net -->
|
|
<!--X-Reference: 20000912114609.A9826@greybeard95a.com -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: man/info debate</title>
|
|
<link rev="made" href="mailto:pac1@tiac.net">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg03861.html">Date Prev</a>][<a href="msg03863.html">Date Next</a>][<a href="msg03856.html">Thread Prev</a>][<a href="msg03858.html">Thread Next</a>][<a href="maillist.html#03862">Date Index</a>][<a href="threads.html#03862">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: man/info debate</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: David Benfell <<A HREF="mailto:benfell@greybeard95a.com">benfell@greybeard95a.com</A>></li>
|
|
<li><em>Subject</em>: Re: man/info debate</li>
|
|
<li><em>From</em>: Patrick Callahan <<A HREF="mailto:pac1@tiac.net">pac1@tiac.net</A>></li>
|
|
<li><em>Date</em>: Wed, 13 Sep 2000 23:09:27 -0400</li>
|
|
<li><em>Cc</em>: Bruce Richardson <<A HREF="mailto:brichardson@lineone.net">brichardson@lineone.net</A>>, "<A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A>" <<A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A>>, Mike Novack <<A HREF="mailto:stepbystepfarm@shaysnet.com">stepbystepfarm@shaysnet.com</A>>, "M. Leo Cooper" <<A HREF="mailto:thegrendel@theriver.com">thegrendel@theriver.com</A>>, Pal Domokos <<A HREF="mailto:pal.domokos@usa.net">pal.domokos@usa.net</A>></li>
|
|
<li><em>References</em>: <<a href="msg03738.html">20000827010903.A12937@alpha.bruce</a>> <<a href="msg03745.html">39A951B8.65AA2A79@tiac.net</a>> <<a href="msg03856.html">20000912114609.A9826@greybeard95a.com</a>></li>
|
|
<li><em>Resent-date</em>: Wed, 13 Sep 2000 23:07:54 -0400 (EDT)</li>
|
|
<li><em>Resent-from</em>: <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
|
|
<li><em>Resent-message-id</em>: <8eBKXD.A.QLG.sFEw5@murphy></li>
|
|
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-discuss-request@lists.debian.org">ldp-discuss-request@lists.debian.org</A></li>
|
|
<li><em>Sender</em>: pac1</li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
David Benfell wrote:
|
|
|
|
>
|
|
> >
|
|
> If I may add a concept to what you state below, in general, available
|
|
> documentation needs to do a much better job of covering the
|
|
> contingencies where something goes wrong. Look at the failure points
|
|
> and stop assuming that they'll be obvious to anyone who follows this
|
|
> path.
|
|
>
|
|
|
|
Thanks That's an important thing to look at. Your comment of course has prompted
|
|
a small cascade of additional questions:
|
|
|
|
What happens when the information point or its context in related information is
|
|
not understood?
|
|
What happens when the usage context is not understood and the information is
|
|
applied in an inappropriate context?
|
|
What errors do users of the information make when trying to appropriately apply
|
|
the information in an appropriate context?
|
|
What systemic failures can be uncovered by attempting to apply the information
|
|
either correctly or incorrectly? What are the consequences?
|
|
|
|
(A reminder for those who may not have followed this thead. The questions I'm
|
|
posing are intentionally very abstract. Most of them you've probably seen
|
|
before. I don't know if anything will come of collecting them or not... yet...
|
|
If all else fails, we can send the list to Letterman as the top things not to ask
|
|
when your trying to write a computer manual for Linux. ;-)
|
|
|
|
-Pat
|
|
|
|
|
|
--
|
|
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
|
|
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
|
|
|
|
</pre>
|
|
|
|
<!--X-Body-of-Message-End-->
|
|
<!--X-MsgBody-End-->
|
|
<!--X-Follow-Ups-->
|
|
<hr>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="03738" href="msg03738.html">Re: man/info debate</a></strong>
|
|
<ul><li><em>From:</em> Bruce Richardson <brichardson@lineone.net></li></ul></li>
|
|
<li><strong><a name="03745" href="msg03745.html">Re: man/info debate</a></strong>
|
|
<ul><li><em>From:</em> Patrick Callahan <pac1@tiac.net></li></ul></li>
|
|
<li><strong><a name="03856" href="msg03856.html">Re: man/info debate</a></strong>
|
|
<ul><li><em>From:</em> David Benfell <benfell@greybeard95a.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg03861.html">Re: License policy proposal</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg03863.html">Re: License policy proposal</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg03856.html">Re: man/info debate</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg03858.html">Re: man/info debate</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#03862"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#03862"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|