151 lines
6.7 KiB
HTML
151 lines
6.7 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Outline for Author's Guide -->
|
|
<!--X-From-R13: "Sqjneq Q. Pnvyrl" <rqNerqung.pbz> -->
|
|
<!--X-Date: Sun, 5 Dec 1999 22:23:53 -0500 (EST) -->
|
|
<!--X-Message-Id: lfyab8n47c.fsf@lacrosse.corp.redhat.com -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: 14411.6824.457038.770755@cmpu.net -->
|
|
<!--X-Reference: Pine.LNX.4.10.9912051030010.21594-100000@jd.linuxports.com -->
|
|
<!--X-Reference: 14411.9809.995760.73135@cmpu.net -->
|
|
<!--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:ed@redhat.com">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg00013.html">Date Prev</a>][<a href="msg00015.html">Date Next</a>][<a href="msg00013.html">Thread Prev</a>][<a href="msg00019.html">Thread Next</a>][<a href="maillist.html#00014">Date Index</a>][<a href="threads.html#00014">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:kclark@ntlug.org">kclark@ntlug.org</A></li>
|
|
<li><em>Subject</em>: Re: Outline for Author's Guide</li>
|
|
<li><em>From</em>: "Edward C. Bailey" <<A HREF="mailto:ed@redhat.com">ed@redhat.com</A>></li>
|
|
<li><em>Date</em>: 05 Dec 1999 22:22:31 -0500</li>
|
|
<li><em>Cc</em>: <A HREF="mailto:ldp-docbook@lists.debian.org">ldp-docbook@lists.debian.org</A></li>
|
|
<li><em>In-reply-to</em>: Kendall Clark's message of "Sun, 5 Dec 1999 20:58:25 -0600 (CST)"</li>
|
|
<li><em>References</em>: <<a href="msg00010.html">14411.6824.457038.770755@cmpu.net</a>> <<a href="msg00011.html">Pine.LNX.4.10.9912051030010.21594-100000@jd.linuxports.com</a>> <<a href="msg00013.html">14411.9809.995760.73135@cmpu.net</a>></li>
|
|
<li><em>Reply-to</em>: "Edward C. Bailey" <<A HREF="mailto:ed@redhat.com">ed@redhat.com</A>></li>
|
|
<li><em>Resent-cc</em>: recipient list not shown: ;</li>
|
|
<li><em>Resent-date</em>: 6 Dec 1999 03:22:39 -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>: <tyEYbD.A.EEG.-vyS4@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>
|
|
(I'll preface my comments by saying I've not seen the AG outline, so
|
|
hopefully I won't be speaking at odds with that document, but here
|
|
goes... :-)
|
|
|
|
>>>>> "Kendall" == Kendall Clark <kclark@ntlug.org> writes:
|
|
|
|
Kendall> I've done enough DocBook with teams of 10 to 20
|
|
Kendall> authors/editors/content-personnel to know that a "quick FAQ" will
|
|
Kendall> not suffice.
|
|
|
|
I'd have to agree. One of the problems I had with our LaTex > DocBook
|
|
conversion was that I didn't have a "best practices" document that I could
|
|
point my staff to, and say, "make your documents adhere to these
|
|
guidelines." I was never more than a week or two ahead of them in terms of
|
|
my knowledge of DocBook, and I quite often found myself having to correct
|
|
their work because they just didn't have a standard to work from.
|
|
|
|
If nothing else, the AG should give the authors some idea of the way to
|
|
handle the more common markup situations, define commonly-used entities,
|
|
etc. A quick review of the available tools would be handy, too (although I
|
|
imagine that as time goes on, this will be less of an issue, as more
|
|
distributions will ship reasonable DocBook-friendly tool configurations).
|
|
|
|
...
|
|
Kendall> This is important so that authors will know which precise DB
|
|
Kendall> constructions they want to use *from among a range of options* to
|
|
Kendall> get the desired effect. Yes, separating content from presentation
|
|
Kendall> is essential to an SGML project; but individual authors are still
|
|
Kendall> going to be asking questions like, 'how do I get this bold or
|
|
Kendall> italic?'. Even if we want to help them think about their documents
|
|
Kendall> in more semantic, and less presentational terms, we still have to
|
|
Kendall> handle the transition cases.
|
|
|
|
Yes, and from what I've seen of linuxdoc, it appeared to be heavily biased
|
|
towards presentation, which will lead to more author confusion/frustration,
|
|
as DocBook is just as heavily biased towards semantics. We used LaTeX
|
|
command definitions that gave reasonably semantic markup (which make our
|
|
conversion to DocBook a bit easier), but even so, my staff was still doing
|
|
ugly things like marking up a sample grep command using <filename> "because
|
|
then it'll come out in Courier". Old habits die hard, but to really
|
|
benefit from SGML's separation of semantics and presentation, you really
|
|
have to make that break completely. I predict this will be an area that
|
|
will require significant effort in order to get the authors on the DocBook
|
|
bandwagon...
|
|
|
|
Ed
|
|
--
|
|
Ed Bailey Red Hat, Inc. <A HREF="http://www.redhat.com/">http://www.redhat.com/</A>
|
|
|
|
|
|
--
|
|
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>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="00010" href="msg00010.html">Re: Outline for Author's Guide</a></strong>
|
|
<ul><li><em>From:</em> Kendall Clark <kclark@ntlug.org></li></ul></li>
|
|
<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>
|
|
<li><strong><a name="00013" href="msg00013.html">Re: Outline for Author's Guide</a></strong>
|
|
<ul><li><em>From:</em> Kendall Clark <kclark@ntlug.org></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg00013.html">Re: Outline for Author's Guide</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg00015.html">Policy issues</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg00013.html">Re: Outline for Author's Guide</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg00019.html">Re: Outline for Author's Guide</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#00014"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#00014"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|