135 lines
5.4 KiB
HTML
135 lines
5.4 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure] -->
|
|
<!--X-From-R13: Yvz Zrfgre <xvzNqshfvba.pbz.nh> -->
|
|
<!--X-Date: Wed, 12 Jan 2000 08:50:39 -0500 (EST) -->
|
|
<!--X-Message-Id: 387C8033.586CB807@dfusion.com.au -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: Pine.LNX.4.10.10001121319060.32479-100000@origo.imsb.au.dk -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</title>
|
|
<link rev="made" href="mailto:kim@dfusion.com.au">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg01035.html">Date Prev</a>][<a href="msg01037.html">Date Next</a>][<a href="msg01034.html">Thread Prev</a>][<a href="msg01051.html">Thread Next</a>][<a href="maillist.html#01036">Date Index</a>][<a href="threads.html#01036">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
|
|
<li><em>Subject</em>: Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</li>
|
|
<li><em>From</em>: Kim Lester <<A HREF="mailto:kim@dfusion.com.au">kim@dfusion.com.au</A>></li>
|
|
<li><em>Date</em>: Wed, 12 Jan 2000 13:22:59 +0000</li>
|
|
<li><em>Organization</em>: Datafusion Systems Pty Ltd</li>
|
|
<li><em>References</em>: <<a href="msg01034.html">Pine.LNX.4.10.10001121319060.32479-100000@origo.imsb.au.dk</a>></li>
|
|
<li><em>Resent-cc</em>: recipient list not shown: ;</li>
|
|
<li><em>Resent-date</em>: 12 Jan 2000 13:48:58 -0000</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>: <v1IcXC.A.5bD.IZIf4@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>: <A HREF="mailto:kim@new-smtp1.ihug.com.au">kim@new-smtp1.ihug.com.au</A></li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
Morten Kjeldgaard wrote:
|
|
>
|
|
> On Tue, 11 Jan 2000, Guylhem Aznar wrote:
|
|
>
|
|
> > Aboloshing the distrinction is a good idea, but it would confuse
|
|
> > people.
|
|
>
|
|
> I don't think it would confuse people, but even so, it would only be those
|
|
> people who are already familiar with the historical distinction. The
|
|
> overwhelming number of people who _need_ the LDP are newcomers to Linux
|
|
> that just want to find the information they need quickly.
|
|
|
|
Exactly! Agree 110%
|
|
Just try explaining why there are HOWTOs and minis to a newbie without
|
|
finding an example document that contradicts ones point.
|
|
|
|
> The key to good documentation is that there are several paths into it. Not
|
|
> everyone thinks the same. _Organization_ is the key to good documentation,
|
|
> and the HOWTO/mini-HOWTO distinction is _not_ good organization.
|
|
|
|
Agree again.
|
|
Everyone has different ideas of what to look under, in an index.
|
|
Don't know about you but often when I look in a (real) technical book
|
|
index it takes several attempts to find what an item has been listed
|
|
under. Often I think the author's/editor's choice is really obscure.
|
|
Eg PPP might be listed under "PPP", "Peer-to-peer", "Networking" or
|
|
even
|
|
"IP", "Protocols". If you're looking in Windoze help it could be listed
|
|
under _anything_ eg "Connecting two machines" or "Dialing your ISP"
|
|
It all depends on the book/author's perspective. For any reasonably
|
|
sized doucmentation set there has to be multiple paths.
|
|
|
|
regards
|
|
Kim Lester
|
|
|
|
|
|
--
|
|
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="01051" href="msg01051.html">Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</a></strong>
|
|
<ul><li><em>From:</em> Guylhem Aznar <guylhem@metalab.unc.edu></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="01034" href="msg01034.html">Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</a></strong>
|
|
<ul><li><em>From:</em> Morten Kjeldgaard <mok@imsb.au.dk></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg01035.html">Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg01037.html">Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg01034.html">Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg01051.html">Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#01036"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#01036"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|