200 lines
6.7 KiB
HTML
200 lines
6.7 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: Fri, 14 Jan 2000 00:42:04 -0500 (EST) -->
|
|
<!--X-Message-Id: 387EB694.4051D02@dfusion.com.au -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: Pine.LNX.4.10.10001131230100.10934-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="msg01063.html">Date Prev</a>][<a href="msg01065.html">Date Next</a>][<a href="msg01053.html">Thread Prev</a>][<a href="msg01079.html">Thread Next</a>][<a href="maillist.html#01064">Date Index</a>][<a href="threads.html#01064">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>: Morten Kjeldgaard <<A HREF="mailto:mok@imsb.au.dk">mok@imsb.au.dk</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>: Fri, 14 Jan 2000 05:39:32 +0000</li>
|
|
<li><em>Cc</em>: Guylhem Aznar <<A HREF="mailto:guylhem@metalab.unc.edu">guylhem@metalab.unc.edu</A>>, <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
|
|
<li><em>Organization</em>: Datafusion Systems Pty Ltd</li>
|
|
<li><em>References</em>: <<a href="msg01053.html">Pine.LNX.4.10.10001131230100.10934-100000@origo.imsb.au.dk</a>></li>
|
|
<li><em>Resent-cc</em>: recipient list not shown: ;</li>
|
|
<li><em>Resent-date</em>: 14 Jan 2000 05:41:34 -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>: <7OUwHD.A.a1D.Ncrf4@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:
|
|
>
|
|
> >
|
|
> > What about a 3 weeks poll where each author can vote :
|
|
> > 1/ Merge the mini HOWTOs with the HOWTOs
|
|
> > 2/ Keep the HOWTOs and the mini HOWTOs separated
|
|
> > 3/ blank
|
|
>
|
|
> Sounds good to me. However, to make peoples decision more enlightened
|
|
> perhaps it would be good with a proof-of-concept. Would it be possible to
|
|
> delay the poll until such a thing is available? I am willing to pitch in,
|
|
> (reorganizing the EXISTING [mini-]?HOWTO documents in a tree structure)
|
|
> but since I am also busy with other things, I cannot do it all alone.
|
|
> Anyone else?
|
|
>
|
|
> /Morten
|
|
|
|
|
|
OK, well I've also got other things to do but I'd like to try and
|
|
help reorganise the HOWTOs.
|
|
I'll say in advance that my solution would probably involve several
|
|
newish aspects (if people think this is bad please comment now):
|
|
|
|
* cutting a number of them up (which cover >1 topic)
|
|
* where docs fall into several categories create a master HTML
|
|
document for each category which points at all the bits
|
|
to form a smooth logic flow.
|
|
|
|
I'll also admit that it was partly the HOWTOs that catalysed the
|
|
ode-discuss list into existence, so I'd be interested in making a
|
|
simple test case of at least some of the HOWTOs. Nothing too
|
|
complex mind you.
|
|
|
|
I'd suggest the network howtos are proably the best example
|
|
to restructure. BTW I think the existing doc contents are
|
|
_great_ so don't anyone think I'm complaing out that.
|
|
The internal structure of some of the latest is also good.
|
|
|
|
What I'm saying is that "Networking" is currently made up of
|
|
roughly the following:
|
|
DNS-
|
|
Ethernet-
|
|
Firewall-
|
|
Hardware-
|
|
IPCHAINS-
|
|
IPX-
|
|
IR-
|
|
ISP-Hookup
|
|
Modem-
|
|
Multicast
|
|
NET-3
|
|
NET3-4
|
|
PPP-
|
|
SMB-
|
|
UUCP-
|
|
Unix-Internet-Fundametnals
|
|
VPN-Masquerade
|
|
WWW-
|
|
|
|
mini/
|
|
Bridge
|
|
Bridge+Firewall
|
|
Cable-Modem
|
|
Cipe+Masq
|
|
DHCP
|
|
DHCPcd
|
|
Diald
|
|
Firewall-Piercing
|
|
IP-Alias
|
|
IP-Masquerade
|
|
IP-Subnetting
|
|
ISP-Connectivity
|
|
Proxy-ARP-Subnet
|
|
Term-Firewall
|
|
Token-Ring
|
|
Windows-Modem-Sharing
|
|
|
|
I didn't realise there were so many!!
|
|
And this doesn't include any distribution/windowing enviornoment
|
|
specific differences.
|
|
|
|
Now in advance I accept that some of you might have a slighly
|
|
different list, but even if you crossed half of the above off
|
|
I still get to make my point.
|
|
|
|
Now you and I, being experienced, don't have a great problem
|
|
picking out the relevant docs.
|
|
You might also say that if you don't understand what a Bridge is
|
|
you wouldn't want to look at that doc. But for example you
|
|
might need some form of PC connectivity, both DHCP and SMB etc
|
|
could be relevant, not obvious.
|
|
|
|
We thus need to provide a contents/index doc that guides
|
|
a person though the documents. This also implies cutting up
|
|
some of the docs as chunks are repeated.
|
|
|
|
Come to think of it this is so "important" I might try doing
|
|
it myself anyway, but would LDP accept the results ??
|
|
|
|
OK everyone now it's your turn to tell me I've got it all wrong :-)
|
|
|
|
cheers
|
|
Kim
|
|
|
|
|
|
--
|
|
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="01053" href="msg01053.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="msg01063.html">Re: fyi: site updates</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg01065.html">Re: Linux Documentation E-Commerce Store Proposal From Talinda Incorporated</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg01053.html">Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg01079.html">Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#01064"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#01064"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|