163 lines
7.0 KiB
HTML
163 lines
7.0 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Category Specialists (was Documentation Metrics) -->
|
|
<!--X-From-R13: Rnivq Znjlre <qnirNynsa.bet> -->
|
|
<!--X-Date: Tue, 17 Oct 2000 20:12:17 -0400 (EDT) -->
|
|
<!--X-Message-Id: 20001017171454.B1823@localhost -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: NLEDLEBJMAFNKPMOMPDEKEBDCAAA.cbuchek@linuxgruven.com -->
|
|
<!--X-Reference: 005801c0384f$cec60670$6401a8c0@nc.ehomecare.com -->
|
|
<!--X-Reference: 00101722515203.05150@charles -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: Category Specialists (was Documentation Metrics)</title>
|
|
<link rev="made" href="mailto:dave@lafn.org">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg04149.html">Date Prev</a>][<a href="msg04151.html">Date Next</a>][<a href="msg04147.html">Thread Prev</a>][<a href="msg04111.html">Thread Next</a>][<a href="maillist.html#04150">Date Index</a>][<a href="threads.html#04150">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: Category Specialists (was Documentation Metrics)</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: jdd <<A HREF="mailto:jdanield@dodin.net">jdanield@dodin.net</A>></li>
|
|
<li><em>Subject</em>: Re: Category Specialists (was Documentation Metrics)</li>
|
|
<li><em>From</em>: David Lawyer <<A HREF="mailto:dave@lafn.org">dave@lafn.org</A>></li>
|
|
<li><em>Date</em>: Tue, 17 Oct 2000 17:14:54 -0700</li>
|
|
<li><em>Cc</em>: <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
|
|
<li><em>In-reply-to</em>: <<a href="msg04140.html">00101722515203.05150@charles</a>></li>
|
|
<li><em>Mail-followup-to</em>: jdd <jdanield@dodin.net>, ldp-discuss@lists.debian.org</li>
|
|
<li><em>References</em>: <<a href="msg04125.html">NLEDLEBJMAFNKPMOMPDEKEBDCAAA.cbuchek@linuxgruven.com</a>> <<a href="msg04126.html">005801c0384f$cec60670$6401a8c0@nc.ehomecare.com</a>> <<a href="msg04140.html">00101722515203.05150@charles</a>></li>
|
|
<li><em>Resent-date</em>: Tue, 17 Oct 2000 20:12:17 -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>: <nRdgFC.A.hP.ntO75@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>User-agent</em>: Mutt/1.0pre3i</li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
On Tue, Oct 17, 2000 at 10:37:49PM +0200, jdd wrote:
|
|
> sorry, folks, but I think there is a problem.
|
|
>
|
|
I agree but I'm pointing up other problems. What we need to consider
|
|
is the cost-benefit ratio of generating the metrics. Are there other
|
|
things we could do that would be of more benefit? So I propose that
|
|
we keep this Metric survey short by only sampling a few paragraphs in
|
|
each HOWTO (and starting by just taking a sample of HOWTOs). If
|
|
anyone reads over an entire HOWTO, all the errors should be noted if
|
|
there are not too many of them (provided one can reach the maintainer
|
|
--see below).
|
|
|
|
I have an idea of what you'll find in your survey. In a number of
|
|
cases you'll find HOWTOs that are not being maintained. Thus making a
|
|
list of comments/errors is to no avail since you can't contact the
|
|
maintainer with this info. What you might do here is to send form
|
|
letters for HOWTOs that are over 2 yrs. old to find out if anyone is
|
|
maintaining it. If so search for a new maintainer.
|
|
|
|
Another important task is to establish a list of HOWTOs where the
|
|
current maintainer is searching for a replacement. If this existed
|
|
less HOWTOs would lapse into being unmaintained.
|
|
|
|
Rating ones own HOWTOs is not very objective. Your own jargon/style
|
|
sounds good to you but may turn off others.
|
|
|
|
What I would like to see as LDP expands are category specialists. We
|
|
would have one for each category. For example the Network Category
|
|
Specialist would read over all the docs on networks and send comments
|
|
to the maintainers. Suggestions might be made re splitting, merging of
|
|
docs. The category specialist would only suggest. No one would have
|
|
to follow the suggestions.
|
|
|
|
Each category specialist might try to keep metrics on the docs.
|
|
Better yet might be a narrative description of the situation and
|
|
problems. I would like to see such narratives open to public access
|
|
Perhaps someone who wanted to read the docs on a certain category
|
|
might look at this narrative first. In some cases, there could be
|
|
specialists for sub-categories. For only a few HOWTOs in a
|
|
sub-category the same person could be both a category specialist and a
|
|
HOWTO maintainer.
|
|
|
|
Then others would reviews the narrative reports and spot check the
|
|
situation to see if everything is OK. People with
|
|
suggestions/complaints on a certain doc would first contact the
|
|
maintainer as they now do. If that didn't work out, they could then
|
|
contact the category specialist. Only if that didn't work out would
|
|
they contact others in the LDP or post to the list.
|
|
|
|
> I'm unsure what this discussion is about.
|
|
>
|
|
> I think initially it was about knowing what documentation was lacking (to
|
|
> try to write it) and giving a help to beginners (initial writing guide)
|
|
>
|
|
[snip]
|
|
> is for no other reason, the only people able really to meter a howto is a
|
|
> people able to write it, and if so he should better work with the author
|
|
> than judge him...
|
|
>
|
|
David Lawyer
|
|
|
|
|
|
--
|
|
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="04125" href="msg04125.html">RE: Documentation Metrics</a></strong>
|
|
<ul><li><em>From:</em> "Craig M. Buchek" <cbuchek@linuxgruven.com></li></ul></li>
|
|
<li><strong><a name="04126" href="msg04126.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="04140" href="msg04140.html">Re: Documentation Metrics</a></strong>
|
|
<ul><li><em>From:</em> jdd <jdanield@dodin.net></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg04149.html">Gnumeric Spreadsheet for Metrics</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg04151.html">Please, i need help....</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg04147.html">Re: Documentation Metrics</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg04111.html">Re: Documentation Metrics</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#04150"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#04150"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|