152 lines
5.9 KiB
HTML
152 lines
5.9 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: RE: Slashdot reply (draft 0.1) -->
|
|
<!--X-From-R13: Vhtb.ina.qre.YbbvwNpnvj.ay -->
|
|
<!--X-Date: Fri, 11 Feb 2000 17:03:27 -0500 (EST) -->
|
|
<!--X-Message-Id: Pine.LNX.4.10.10002112218140.20440-100000@bastion.hugo.vanderkooij.org -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: A5F46F4ED18FD211ABEE00105AC6CF077F7C14@email.cu-portland.edu -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>RE: Slashdot reply (draft 0.1)</title>
|
|
<link rev="made" href="mailto:Hugo.van.der.Kooij@caiw.nl">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg01402.html">Date Prev</a>][<a href="msg01404.html">Date Next</a>][<a href="msg01401.html">Thread Prev</a>][<a href="msg01424.html">Thread Next</a>][<a href="maillist.html#01403">Date Index</a>][<a href="threads.html#01403">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>RE: Slashdot reply (draft 0.1)</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: Gregory Leblanc <<A HREF="mailto:GLeblanc@cu-portland.edu">GLeblanc@cu-portland.edu</A>></li>
|
|
<li><em>Subject</em>: RE: Slashdot reply (draft 0.1)</li>
|
|
<li><em>From</em>: <A HREF="mailto:Hugo.van.der.Kooij@caiw.nl">Hugo.van.der.Kooij@caiw.nl</A></li>
|
|
<li><em>Date</em>: Fri, 11 Feb 2000 22:26:51 +0100 (CET)</li>
|
|
<li><em>Cc</em>: <A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A></li>
|
|
<li><em>In-reply-to</em>: <<a href="msg01396.html">A5F46F4ED18FD211ABEE00105AC6CF077F7C14@email.cu-portland.edu</a>></li>
|
|
<li><em>Resent-cc</em>: recipient list not shown: ;</li>
|
|
<li><em>Resent-date</em>: 11 Feb 2000 21:31:12 -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>: <EAKOVC.A.j9C.e-Hp4@murphy></li>
|
|
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-discuss-request@lists.debian.org">ldp-discuss-request@lists.debian.org</A></li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
On Fri, 11 Feb 2000, Gregory Leblanc wrote:
|
|
|
|
> <flame>This is really stupid. I'm sure there's a logic behind this, but I
|
|
> can't grasp what it is. I understand why these were put in place, but not
|
|
> why they're still in use. We should abolish silly distinctions to allow
|
|
> authors to more easily submit documents, especially since we're accepting
|
|
> DocBook. Hugo van der Wahls (I think I spelled that right) has made some
|
|
> RPMs of the new versions of SGMLTools, so at least some people can do the
|
|
> translation from DocBook to other formats. Calling your document a FAQ
|
|
> because you don't know any breed of SGML other than HTML is silly. If we're
|
|
> going to use the terms "FAQ", "HOWTO", "GUIDE", and whatever else, it should
|
|
> be because the document logically is a FAQ, because it's a series of
|
|
> questions, or a HOWTO, because it tells HOW TO do something. If we're going
|
|
> to classify documents by their format, let's just DO IT, and make categories
|
|
> based on format. But the best thing for users is to classify documents by
|
|
> structure/content, and keep sections like HOWTO, FAQ, etc. If necessary, we
|
|
> could break sections down something similar to:
|
|
|
|
<Water>
|
|
The author seems to mix Hugo van der Kooij and Norman Walsh. So this
|
|
bucket of water will cool the heat of this flame.
|
|
</Water>
|
|
|
|
But I agree the distinction between the various types should be made based
|
|
on the content.
|
|
|
|
So I suggest:
|
|
|
|
- Howto Focus on getting the job done
|
|
- Guide Focus on telling you what the subject is al about
|
|
- FAQ Questions and Answers
|
|
- Others
|
|
|
|
It's hard to draw a straight line as a Howto may end up becoming a Guide
|
|
in the long run. The goal should be to allow as many technical formats as
|
|
possible. That would mean document written in:
|
|
- Linuxdoc SGML
|
|
- DocBook SGML
|
|
- ASCII
|
|
- HTML
|
|
- LaTeX
|
|
|
|
Just my 0.02 Euro's.
|
|
|
|
Hugo.
|
|
|
|
--
|
|
Hugo van der Kooij; Oranje Nassaustraat 16; 3155 VJ Maasland
|
|
hvdkooij@caiw.nl <A HREF="http://home.kabelfoon.nl/~hvdkooij/">http://home.kabelfoon.nl/~hvdkooij/</A>
|
|
--------------------------------------------------------------
|
|
Use of any of my email addresses for unsollicited (commercial)
|
|
email is a clear intrusion of my privacy and illegal!
|
|
|
|
|
|
--
|
|
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="01424" href="msg01424.html">Re: Slashdot reply (draft 0.1)</a></strong>
|
|
<ul><li><em>From:</em> "Greg O'Keefe" <gcokeefe@postoffice.utas.edu.au></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="01396" href="msg01396.html">RE: Slashdot reply (draft 0.1)</a></strong>
|
|
<ul><li><em>From:</em> Gregory Leblanc <GLeblanc@cu-portland.edu></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg01402.html">Re: Slashdot reply (draft 0.1)</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg01404.html">Re: Slashdot reply (draft 0.1)</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg01401.html">Re: Slashdot reply (draft 0.1)</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg01424.html">Re: Slashdot reply (draft 0.1)</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#01403"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#01403"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|