144 lines
5.4 KiB
HTML
144 lines
5.4 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Outline for Author's Guide -->
|
|
<!--X-From-R13: Fvz <gwolahzNjnyylobk.prv.arg> -->
|
|
<!--X-Date: Sun, 5 Dec 1999 21:43:15 -0500 (EST) -->
|
|
<!--X-Message-Id: Pine.LNX.4.10.9912052109250.17199-100000@wallybox.cei.net -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: Pine.LNX.4.10.9912051030010.21594-100000@jd.linuxports.com -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: Outline for Author's Guide</title>
|
|
<link rev="made" href="mailto:tjbynum@wallybox.cei.net">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg00011.html">Date Prev</a>][<a href="msg00013.html">Date Next</a>][<a href="msg00011.html">Thread Prev</a>][<a href="msg00016.html">Thread Next</a>][<a href="maillist.html#00012">Date Index</a>][<a href="threads.html#00012">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: Outline for Author's Guide</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: <A HREF="mailto:ldp-docbook@lists.debian.org">ldp-docbook@lists.debian.org</A></li>
|
|
<li><em>Subject</em>: Re: Outline for Author's Guide</li>
|
|
<li><em>From</em>: Tim <<A HREF="mailto:tjbynum@wallybox.cei.net">tjbynum@wallybox.cei.net</A>></li>
|
|
<li><em>Date</em>: Sun, 5 Dec 1999 21:15:19 -0600 (CST)</li>
|
|
<li><em>In-reply-to</em>: <<a href="msg00011.html">Pine.LNX.4.10.9912051030010.21594-100000@jd.linuxports.com</a>></li>
|
|
<li><em>Resent-cc</em>: recipient list not shown: ;</li>
|
|
<li><em>Resent-date</em>: 6 Dec 1999 02:43:11 -0000</li>
|
|
<li><em>Resent-from</em>: <A HREF="mailto:ldp-docbook@lists.debian.org">ldp-docbook@lists.debian.org</A></li>
|
|
<li><em>Resent-message-id</em>: <LGGgt.A.SNF._KyS4@murphy></li>
|
|
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-docbook-request@lists.debian.org">ldp-docbook-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>
|
|
|
|
|
|
> It seems to me that this a little more complicated than it needs to be.
|
|
> Yes DocBook is a large beast but it is not uncontrollable. A quick FAQ on
|
|
> what is good practice and not good practice should suffice.
|
|
|
|
It is *not* too complicated. This must be done and there are no if ands
|
|
or buts about it.
|
|
|
|
We need a true Author's Guide and there's never been one. The closest one
|
|
that we have now is the HOWTO-HOWTO and even that is lacking quite a bit
|
|
(no offense Mark).
|
|
|
|
Guidelines have to be set and they must be followed. Withouth putting
|
|
this committee together this will *never* happen and they just cannot be
|
|
the case.
|
|
|
|
We're now working with a CVS Repository and if there are no guidelines set
|
|
forth now, it will make automating things an absolute nightmare once we
|
|
make the transition to DocBook.
|
|
|
|
I want the authors/maintainers know what is expected of them and I don't
|
|
want to leave much to chance.
|
|
|
|
> I agree with Kendall in regards to the tools. No we don't have the ability
|
|
> to just type sgmltools html index.sgml and get what we want BUT we can
|
|
> type jade <arguments> <stylesheet> index.sgml and get what we want.
|
|
> Heck, if we stick with specific style sheets we should be fine. Just state
|
|
> in the FAQ that we accept these version of the style sheets and these
|
|
> "features".
|
|
|
|
I've talked to Kendall and perhaps I should have worded things
|
|
differently. I do *not* want to roll our own tools out. Yes there are
|
|
tools out there and I'm sure most of us (at least here) are aware of this.
|
|
I want the authors/maintainers to know exactly what is out there and how
|
|
they can use them.
|
|
|
|
I am not interested in gathering tools and then turning around and giving
|
|
them to the authors and maintainers. I only want to make them aware of
|
|
what is there for them.
|
|
|
|
I stand corrected and now wish to address the task of creating the AG
|
|
(Author's Guide).
|
|
|
|
-tim
|
|
|
|
|
|
--
|
|
To UNSUBSCRIBE, email to ldp-docbook-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="00016" href="msg00016.html">Re: Outline for Author's Guide</a></strong>
|
|
<ul><li><em>From:</em> "Poet/Joshua D. Drake" <poet@linuxports.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="00011" href="msg00011.html">Re: Outline for Author's Guide</a></strong>
|
|
<ul><li><em>From:</em> "Poet/Joshua D. Drake" <poet@linuxports.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg00011.html">Re: Outline for Author's Guide</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg00013.html">Re: Outline for Author's Guide</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg00011.html">Re: Outline for Author's Guide</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg00016.html">Re: Outline for Author's Guide</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#00012"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#00012"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|