old-www/pub/Linux/docs/ldp-archived/mail_archives/ldp-discuss/msg03022.html

134 lines
5.2 KiB
HTML

<!-- MHonArc v2.5.0b2 -->
<!--X-Subject: Re: HOWTOs in DocBook SGML? -->
<!--X-From-R13: Unel Znjerapr [hecul <tnelzNpnanqn.pbz> -->
<!--X-Date: Sun, 25 Jun 2000 23:03:17 &#45;0400 (EDT) -->
<!--X-Message-Id: m38zvt9mao.fsf@maya.linux.ca -->
<!--X-Content-Type: text/plain -->
<!--X-Reference: A5F46F4ED18FD211ABEE00105AC6CF070109383B@email.cu&#45;portland.edu -->
<!--X-Head-End-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>Re: HOWTOs in DocBook SGML?</title>
<link rev="made" href="mailto:garym@canada.com">
</head>
<body>
<!--X-Body-Begin-->
<!--X-User-Header-->
<!--X-User-Header-End-->
<!--X-TopPNI-->
<hr>
[<a href="msg03021.html">Date Prev</a>][<a href="msg03023.html">Date Next</a>][<a href="msg03021.html">Thread Prev</a>][<a href="msg03024.html">Thread Next</a>][<a href="maillist.html#03022">Date Index</a>][<a href="threads.html#03022">Thread Index</a>]
<!--X-TopPNI-End-->
<!--X-MsgBody-->
<!--X-Subject-Header-Begin-->
<h1>Re: HOWTOs in DocBook SGML?</h1>
<hr>
<!--X-Subject-Header-End-->
<!--X-Head-of-Message-->
<ul>
<li><em>To</em>: Gregory Leblanc &lt;<A HREF="mailto:GLeblanc@cu-portland.edu">GLeblanc@cu-portland.edu</A>&gt;</li>
<li><em>Subject</em>: Re: HOWTOs in DocBook SGML?</li>
<li><em>From</em>: Gary Lawrence Murphy &lt;<A HREF="mailto:garym@canada.com">garym@canada.com</A>&gt;</li>
<li><em>Date</em>: 25 Jun 2000 23:02:55 -0400</li>
<li><em>Cc</em>: <A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A></li>
<li><em>Organization</em>: T(c)Inc Business Innovation through Open Source Computing</li>
<li><em>References</em>: &lt;<a href="msg03021.html">A5F46F4ED18FD211ABEE00105AC6CF070109383B@email.cu-portland.edu</a>&gt;</li>
<li><em>Reply-to</em>: Gary Lawrence Murphy &lt;<A HREF="mailto:garym@canada.com">garym@canada.com</A>&gt;</li>
<li><em>Resent-date</em>: Sun, 25 Jun 2000 23:03: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>: &lt;MxXCFC.A.70E.HgsV5@murphy&gt;</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:garym@maya.linux.ca">garym@maya.linux.ca</A></li>
</ul>
<!--X-Head-of-Message-End-->
<!--X-Head-Body-Sep-Begin-->
<hr>
<!--X-Head-Body-Sep-End-->
<!--X-Body-of-Message-->
<pre>
&gt;&gt;&gt;&gt;&gt; &quot;G&quot; == Gregory Leblanc &lt;GLeblanc@cu-portland.edu&gt; writes:
G&gt; Personally, I think that one of the best people to take after
G&gt; would be Asimov. His text books and other non-fiction works
G&gt; are loads of fun to read, and easy to understand. Isn't that
G&gt; the point of documentation? Greg
Personally, I found Martin's little joyceism to be packed with
fantastic detail in an amazingly terse space. Ok, it's not easy to
read on the surface, but once you grasped it, it taught you about the
book, author AND the library in one shot ;)
Seriously, though, you are absolutely right and thus the discussion
on writing guides truly belongs in the HOWTO-HOWTO. So far, we have
collected
1) George Orwell's guide (free, online and totally useful)
2) Strunk and White (small, cheap and essential)
3) Hart's guide sadly out of print, even after being
revised for electronic media.
IMHO, we could do more to improve the quality of our docs by requiring
these works as pre-requisites than we could from any amount of
technology.
Hmmm ... hey, let's start a contest: Linux Technical Haiku!
--
Gary Lawrence Murphy &lt;garym@linux.ca&gt;: office voice/fax: 01 519 4222723
TCI - Business Innovations through Open Source : <A HREF="http://www.teledyn.com">http://www.teledyn.com</A>
Love Linux? We need authors/reviewers - <A HREF="http://www.teledyn.com/authors">http://www.teledyn.com/authors</A>
--
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of &quot;unsubscribe&quot;. 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="03024" href="msg03024.html">LTH [Was: HOWTOs in DocBook SGML?]</a></strong>
<ul><li><em>From:</em> Jeff Waugh &lt;jdub@aphid.net&gt;</li></ul></li>
</ul></li></ul>
<!--X-Follow-Ups-End-->
<!--X-References-->
<ul><li><strong>References</strong>:
<ul>
<li><strong><a name="03021" href="msg03021.html">RE: HOWTOs in DocBook SGML?</a></strong>
<ul><li><em>From:</em> Gregory Leblanc &lt;GLeblanc@cu-portland.edu&gt;</li></ul></li>
</ul></li></ul>
<!--X-References-End-->
<!--X-BotPNI-->
<ul>
<li>Prev by Date:
<strong><a href="msg03021.html">RE: HOWTOs in DocBook SGML?</a></strong>
</li>
<li>Next by Date:
<strong><a href="msg03023.html">Re: Simplified DocBook</a></strong>
</li>
<li>Previous by thread:
<strong><a href="msg03021.html">RE: HOWTOs in DocBook SGML?</a></strong>
</li>
<li>Next by thread:
<strong><a href="msg03024.html">LTH [Was: HOWTOs in DocBook SGML?]</a></strong>
</li>
<li>Index(es):
<ul>
<li><a href="maillist.html#03022"><strong>Date</strong></a></li>
<li><a href="threads.html#03022"><strong>Thread</strong></a></li>
</ul>
</li>
</ul>
<!--X-BotPNI-End-->
<!--X-User-Footer-->
<!--X-User-Footer-End-->
</body>
</html>