166 lines
6.9 KiB
HTML
166 lines
6.9 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Documentation Metrics -->
|
|
<!--X-From-R13: Rnivq [reevyy <qpzreevyyNzvaqfcevat.pbz> -->
|
|
<!--X-Date: Tue, 17 Oct 2000 08:11:15 -0400 (EDT) -->
|
|
<!--X-Message-Id: 39EC425E.225DF03A@mindspring.com -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: NLEDLEBJMAFNKPMOMPDEKEAPCAAA.cbuchek@linuxgruven.com -->
|
|
<!--X-Reference: 005901c037ab$141d6560$6401a8c0@nc.ehomecare.com -->
|
|
<!--X-Reference: kpitqscnym.fsf@dagon.conectiva -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: Documentation Metrics</title>
|
|
<link rev="made" href="mailto:dcmerrill@mindspring.com">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg04117.html">Date Prev</a>][<a href="msg04119.html">Date Next</a>][<a href="msg04114.html">Thread Prev</a>][<a href="msg04119.html">Thread Next</a>][<a href="maillist.html#04118">Date Index</a>][<a href="threads.html#04118">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: Documentation Metrics</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: Jorge Godoy <<A HREF="mailto:godoy@conectiva.com">godoy@conectiva.com</A>></li>
|
|
<li><em>Subject</em>: Re: Documentation Metrics</li>
|
|
<li><em>From</em>: David Merrill <<A HREF="mailto:dcmerrill@mindspring.com">dcmerrill@mindspring.com</A>></li>
|
|
<li><em>Date</em>: Tue, 17 Oct 2000 08:13:18 -0400</li>
|
|
<li><em>Cc</em>: LDP-Discuss <<A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A>></li>
|
|
<li><em>Old-return-path</em>: dcmerrill@mindspring.com</li>
|
|
<li><em>References</em>: <<a href="msg04102.html">NLEDLEBJMAFNKPMOMPDEKEAPCAAA.cbuchek@linuxgruven.com</a>> <<a href="msg04103.html">005901c037ab$141d6560$6401a8c0@nc.ehomecare.com</a>> <<a href="msg04114.html">kpitqscnym.fsf@dagon.conectiva</a>></li>
|
|
<li><em>Resent-date</em>: Tue, 17 Oct 2000 08:11:15 -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>: <_rZrAD.A.lpG.oJE75@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>: dmerrill</li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
Jorge Godoy wrote:
|
|
>
|
|
> >>>>> On Mon, 16 Oct 2000 15:55:47 -0400, "David C. Merrill, Ph.D." <dcmerrill@mindspring.com> said:
|
|
>
|
|
> DCMPD> From: "Craig M. Buchek" <cbuchek@linuxgruven.com>
|
|
> >> From: David C. Merrill, Ph.D. [<A HREF="mailto:dcmerrill@mindspring.com">mailto:dcmerrill@mindspring.com</A>]
|
|
> >> > 1. Audience Type
|
|
> >> > - application user
|
|
> >> > - programmer
|
|
> >> > - system administrator
|
|
> >>
|
|
> >> One document may apply to some or all.
|
|
>
|
|
> DCMPD> Indicate all that apply.
|
|
>
|
|
> It could be based on the catalog that Kevin is building... Or it could
|
|
> be used by Kevin. There are overlapping tasks here. I suggest that you
|
|
> get in touch and divide them to make the process faster.
|
|
|
|
I think the tasks are somewhat overlapping, but Kevin and I are in
|
|
contact and are sharing ideas through the list, where everyone can
|
|
comment.
|
|
|
|
> DCMPD> Most documents only apply to one of these audiences, however. And a good
|
|
> DCMPD> argument can be made that a HOWTO that doesn't target one of these three
|
|
> DCMPD> should be split into two.
|
|
>
|
|
> Sorry, could you explain it better? If one HOWTO applies to more than
|
|
> one of these it should be split to match only one? (sorry... I'm
|
|
> almost sleeping and trying to put LDP messages up to date)
|
|
|
|
I said only that you can make such an argument. You can also make a good
|
|
argument for keeping it together.
|
|
|
|
My goal is to identify areas where we provide advanced information, but
|
|
nothing suitable for beginners, or helpful to them. And vice versa. I'm
|
|
not saying we should split them. The comment about an argument for
|
|
splitting was just a side comment.
|
|
|
|
> DCMPD> Seriously, though, this information is not going to be publicized. It is for
|
|
> DCMPD> my personal use, and perhaps for a few others that help me. And, if the
|
|
> DCMPD> document is really awful, I have no problem saying so. One thing you can
|
|
> DCMPD> count on me for is being honest about our shortcomings. How else can we
|
|
> DCMPD> address them?
|
|
>
|
|
> If you don't mind, it would be interesting for an author to have
|
|
> access to this information on her/his HOWTO/document. This way people
|
|
> might know where they need to improve their document (besides
|
|
> content).
|
|
|
|
I'll be getting in contact with authors whose work needs updating or
|
|
improving. I won't write them to say that their HOWTO sucks, though. I
|
|
will try to be just a bit more diplomatic than that. ;-)
|
|
|
|
--
|
|
David C. Merrill, Ph.D.
|
|
Linux Documentation Project
|
|
Collection Editor & Coordinator
|
|
www.LinuxDoc.org
|
|
|
|
|
|
--
|
|
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>
|
|
<ul><li><strong>Follow-Ups</strong>:
|
|
<ul>
|
|
<li><strong><a name="04119" href="msg04119.html">Re: Documentation Metrics</a></strong>
|
|
<ul><li><em>From:</em> Jorge Godoy <godoy@conectiva.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="04102" href="msg04102.html">RE: Documentation Metrics</a></strong>
|
|
<ul><li><em>From:</em> "Craig M. Buchek" <cbuchek@linuxgruven.com></li></ul></li>
|
|
<li><strong><a name="04103" href="msg04103.html">Re: Documentation Metrics</a></strong>
|
|
<ul><li><em>From:</em> "David C. Merrill, Ph.D." <dcmerrill@mindspring.com></li></ul></li>
|
|
<li><strong><a name="04114" href="msg04114.html">Re: Documentation Metrics</a></strong>
|
|
<ul><li><em>From:</em> Jorge Godoy <godoy@conectiva.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg04117.html">A new Mini-HOWTO?</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg04119.html">Re: Documentation Metrics</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg04114.html">Re: Documentation Metrics</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg04119.html">Re: Documentation Metrics</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#04118"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#04118"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|