126 lines
4.6 KiB
HTML
126 lines
4.6 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Blank template -->
|
|
<!--X-From-R13: Rnivq [reevyy <qpzreevyyNzvaqfcevat.pbz> -->
|
|
<!--X-Date: Thu, 15 Jun 2000 08:05:53 -0400 (EDT) -->
|
|
<!--X-Message-Id: 00061508042301.11445@localhost.localdomain -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: A5F46F4ED18FD211ABEE00105AC6CF07010937AF@email.cu-portland.edu -->
|
|
<!--X-Reference: 20000615212719.S11884@aphid.net -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: Blank template</title>
|
|
<link rev="made" href="mailto:dcmerrill@mindspring.com">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg02850.html">Date Prev</a>][<a href="msg02852.html">Date Next</a>][<a href="msg02850.html">Thread Prev</a>][<a href="msg02852.html">Thread Next</a>][<a href="maillist.html#02851">Date Index</a>][<a href="threads.html#02851">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: Blank template</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: <A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A></li>
|
|
<li><em>Subject</em>: Re: Blank template</li>
|
|
<li><em>From</em>: David Merrill <<A HREF="mailto:dcmerrill@mindspring.com">dcmerrill@mindspring.com</A>></li>
|
|
<li><em>Date</em>: Thu, 15 Jun 2000 07:56:28 -0400</li>
|
|
<li><em>In-reply-to</em>: <<a href="msg02850.html">20000615212719.S11884@aphid.net</a>></li>
|
|
<li><em>References</em>: <<a href="msg02847.html">A5F46F4ED18FD211ABEE00105AC6CF07010937AF@email.cu-portland.edu</a>> <<a href="msg02850.html">20000615212719.S11884@aphid.net</a>></li>
|
|
<li><em>Resent-date</em>: Thu, 15 Jun 2000 08:05:53 -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>: <Su6PLD.A.yqC.raMS5@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 Thu, 15 Jun 2000, Chuck Dale wrote:
|
|
> > > > So, am I going a good direction with this? Too many
|
|
> > > comments? Too few?
|
|
> > > > Greg
|
|
> > >
|
|
> > > I'm assuming this is aimed at the extreme novice Docbook
|
|
> > > author; if so, you're
|
|
> > > right to err on the side of overkill.
|
|
> >
|
|
> > ok, I'll stick with lots of comments.
|
|
>
|
|
> Ah I'll throw a paddle back in the other direction: way too many
|
|
> comments. The template needs to be concise to be usable, and some things
|
|
> are overkill. Like this:
|
|
[...]
|
|
|
|
I agree with Chuck. I'd rather the template be just that -- a template. No more
|
|
and no less. With the entire text of DocBook: TDG available online, there's an
|
|
excellent reference available to everyone, to explain the meaning of any tag.
|
|
|
|
I have a bias toward keeping all the documentation together in one document,
|
|
the LDP-Authoring-HOWTO, instead of spread out between there and comments in
|
|
the template(s). I see the template as a kind of "Appendix", or supplemental
|
|
material, to the Authoring-HOWTO. It doesn't need to stand on its own.
|
|
|
|
|
|
--
|
|
David C. Merrill, Ph.D.
|
|
dcmerrill@mindspring.com
|
|
|
|
|
|
--
|
|
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="02847" href="msg02847.html">RE: Blank template</a></strong>
|
|
<ul><li><em>From:</em> Gregory Leblanc <GLeblanc@cu-portland.edu></li></ul></li>
|
|
<li><strong><a name="02850" href="msg02850.html">Re: Blank template</a></strong>
|
|
<ul><li><em>From:</em> Chuck Dale <bug@aphid.net></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg02850.html">Re: Blank template</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg02852.html">Re: Blank template</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg02850.html">Re: Blank template</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg02852.html">Re: Blank template</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#02851"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#02851"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|