180 lines
7.2 KiB
HTML
180 lines
7.2 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Cataloging LDP -->
|
|
<!--X-From-R13: Yriva Qhyyvf <xrivaphNbepv.pbz> -->
|
|
<!--X-Date: Fri, 13 Oct 2000 15:29:51 -0400 (EDT) -->
|
|
<!--X-Message-Id: 39E73D6C.255C5EC3@orci.com -->
|
|
<!--X-Content-Type: multipart/mixed -->
|
|
<!--X-Reference: 39E39059.C456413A@orci.com -->
|
|
<!--X-Reference: 39E6E538.E7A78677@mail.nyx.net -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: Cataloging LDP</title>
|
|
<link rev="made" href="mailto:kevincu@orci.com">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg04069.html">Date Prev</a>][<a href="msg04071.html">Date Next</a>][<a href="msg04059.html">Thread Prev</a>][<a href="msg04035.html">Thread Next</a>][<a href="maillist.html#04070">Date Index</a>][<a href="threads.html#04070">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: Cataloging LDP</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: Stein Gjoen <<A HREF="mailto:sgjoen@mail.nyx.net">sgjoen@mail.nyx.net</A>></li>
|
|
<li><em>Subject</em>: Re: Cataloging LDP</li>
|
|
<li><em>From</em>: Kevin Cullis <<A HREF="mailto:kevincu@orci.com">kevincu@orci.com</A>></li>
|
|
<li><em>Date</em>: Fri, 13 Oct 2000 10:50:52 -0600</li>
|
|
<li><em>Cc</em>: Greg Ferguson <<A HREF="mailto:gferg@hoop.timonium.sgi.com">gferg@hoop.timonium.sgi.com</A>>, David Lawyer <<A HREF="mailto:dave@lafn.org">dave@lafn.org</A>>, LDP Discuss List <<A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A>></li>
|
|
<li><em>References</em>: <<a href="msg04027.html">39E39059.C456413A@orci.com</a>> <<a href="msg04059.html">39E6E538.E7A78677@mail.nyx.net</a>></li>
|
|
<li><em>Resent-date</em>: Fri, 13 Oct 2000 15:29:51 -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>: <QteLKD.A.70D.wM255@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:kevin@mx1.viawest.net">kevin@mx1.viawest.net</A></li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
Stein Gjoen wrote:
|
|
>
|
|
> Kevin Cullis wrote:
|
|
> [snip]
|
|
> > 1 Process
|
|
> > 1.1 Linux Development
|
|
> > 1.1.1 Theory/Philosophy
|
|
> > 1.1.2 Planning: Architect Design/Requirements Gathering
|
|
> > 1.1.3 Coding
|
|
> > 1.1.4 Compiling
|
|
> > 1.1.5 Testing
|
|
> > 1.1.6 Release/Acceptance
|
|
> > 1.1.7 Maintenance
|
|
> > 1.2 Linux User and Administration
|
|
> > 1.2.1 Background Information
|
|
> > 1.2.2 Pre-installation requirements (chipset or specifications of
|
|
> > hardware, etc.)
|
|
> > 1.2.3 Installation
|
|
> > 1.2.4 Configuration
|
|
> > 1.2.5 Maintenance/Tune-up
|
|
> > 1.2.6 Troubleshooting
|
|
> > 1.2.6.1 Pre- and Post-Dependencies of subject matter ( what items
|
|
> > affect it working correctly)
|
|
> > 1.2.6.2 Where to go for more info (i.e. to manufacturer for specs)
|
|
>
|
|
> Funny, this list is not entirely unlike the structure in the
|
|
> Template
|
|
> <A HREF="http://www.nyx.net/~sgjoen/template.html">http://www.nyx.net/~sgjoen/template.html</A>
|
|
>
|
|
> > The one question I have not figured out yet, is how to do a
|
|
> > Beginner/Intermediate/Advanced sort of subject matter. Should we
|
|
> > reclassify some things to basics/intermediate/advanced? Let me know.
|
|
>
|
|
> The way I see it a HOWTO should cater for the entire range of
|
|
> readers, hopefully bringing the novice up to speed. I added a
|
|
> reading plan to my HOWTO,and also the template (chapter 2.3) on
|
|
> request from a reader.
|
|
|
|
Not only a range of readers, but a range of HOWTOs, by that I mean some
|
|
HOWTOs are not really HOWTOs but general reading stuff or background
|
|
stuff which leaves me with a "What's this" sort of thing. I'm not
|
|
knocking them, but the classification of information within the HOWTOs
|
|
makes it difficult to find the right information quickly.
|
|
|
|
>
|
|
> How does this scheme fit in with your views?
|
|
|
|
We're thinking along the same lines with what you've started, however,
|
|
let's back up a bit. While you've written (or are writing) a HOWTO for
|
|
big HOWTOs, the question has to be asked: why are there big HOWTOs? If
|
|
you take a survey of the HOWTOs, mini-HOWTOs, etc. and see WHAT type of
|
|
information is in each you find that all of them have similar
|
|
information, but when you look at the title HOWTO or mini-HOWTO via the
|
|
length or subject matter, then nothing is very consistent, at least
|
|
that's what I'm seeing. So if what I'm seeing is accurate
|
|
(inconsistency between docs, such as a mini-HOWTO needing to become a
|
|
HOWTO, etc), then what of the first time user, or for that matter the
|
|
business manager who's looking at Linux, what do they think? That's why
|
|
I'm taking the next two months off to do, to propose cleaning up the
|
|
inconsistencies to make it easier to find answers by creating a
|
|
cataloging system as well as creating definitions and logical flow of
|
|
what each document should contain.. My hope is that everyone will like
|
|
what I propose, but I would expect that it will require rewrites and
|
|
reorganizations of Linux docs. But then the benefit will be much cleaner
|
|
and focused docs.
|
|
|
|
Does this help? I should have a rough draft in the next two weeks since
|
|
this entails a cataloging system, reorganizing the logical flow of docs,
|
|
and adding some features to which it will make finding answers easier.
|
|
|
|
>
|
|
> Regards,
|
|
> Stein Gjoen
|
|
>
|
|
> --
|
|
> To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
|
|
> with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org</pre>
|
|
<pre>
|
|
begin:vcard
|
|
n:Cullis;Kevin
|
|
tel;home:720-489-9283
|
|
x-mozilla-html:FALSE
|
|
adr:;;8285 S Poplar Way #202;Englewood;CO;80112;USA
|
|
version:2.1
|
|
email;internet:kevincu@orci.com
|
|
x-mozilla-cpt:;0
|
|
fn:Kevin Cullis
|
|
end:vcard
|
|
</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="04027" href="msg04027.html">Cataloging LDP</a></strong>
|
|
<ul><li><em>From:</em> Kevin Cullis <kevincu@orci.com></li></ul></li>
|
|
<li><strong><a name="04059" href="msg04059.html">Re: Cataloging LDP</a></strong>
|
|
<ul><li><em>From:</em> Stein Gjoen <sgjoen@mail.nyx.net></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg04069.html">Cataloging LDP White Paper: Document Reorganization</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg04071.html">Re: Cataloging LDP White Paper: Document Reorganization</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg04059.html">Re: Cataloging LDP</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg04035.html">Ethernet Cards</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#04070"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#04070"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|