140 lines
5.1 KiB
HTML
140 lines
5.1 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: author's guide -->
|
|
<!--X-From-R13: Rro Dvpuneqfba <qroNgurchssvatebhc.pbz> -->
|
|
<!--X-Date: Mon, 6 Dec 1999 20:13:23 -0500 (EST) -->
|
|
<!--X-Message-Id: 384C5FD7.16F907F4@thepuffingroup.com -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>author's guide</title>
|
|
<link rev="made" href="mailto:deb@thepuffingroup.com">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg00024.html">Date Prev</a>][<a href="msg00026.html">Date Next</a>][<a href="msg00023.html">Thread Prev</a>][<a href="msg00028.html">Thread Next</a>][<a href="maillist.html#00025">Date Index</a>][<a href="threads.html#00025">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>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>: author's guide</li>
|
|
<li><em>From</em>: Deb Richardson <<A HREF="mailto:deb@thepuffingroup.com">deb@thepuffingroup.com</A>></li>
|
|
<li><em>Date</em>: Mon, 06 Dec 1999 20:16:07 -0500</li>
|
|
<li><em>Organization</em>: The Puffin Group</li>
|
|
<li><em>Resent-cc</em>: recipient list not shown: ;</li>
|
|
<li><em>Resent-date</em>: 7 Dec 1999 01:11:56 -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>: <T2Q-BB.A.l3H.b7FT4@murphy></li>
|
|
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-docbook-request@lists.debian.org">ldp-docbook-request@lists.debian.org</A></li>
|
|
<li><em>Sender</em>: <A HREF="mailto:deb@murphy.debian.org">deb@murphy.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>
|
|
Hi there.
|
|
|
|
I've just been catching up on my email (been away on business for the
|
|
last week), and I've noticed that there is a lot of discussion regarding
|
|
an Author's Guide to DocBook on this list. I'd be interested in seeing
|
|
the outline if it's available.
|
|
|
|
I've also recently started a project to produce what I'm calling a
|
|
"Practical Introduction to DocBook". Obviously such a book is sorely
|
|
needed by the open-source documentation community. I had originally
|
|
started writing one on my own, but it is a very large project that
|
|
really should be a collaborative work (few of us have time to write a
|
|
whole book in our spare time :)
|
|
|
|
I've put together a website for the project, which includes my first
|
|
stab at an outline. I would very much like feedback on it -- I'm
|
|
relatively new to DocBook, and I may have missed a few things. The
|
|
project site is here:
|
|
|
|
<A HREF="http://www.oswg.org/pid/">http://www.oswg.org/pid/</A>
|
|
|
|
This sort of book is of use to all open-source documentation projects --
|
|
the LDP, the OSWG, the FreeBSD DP, the GNOME DP, etc. Rather than
|
|
having a number of different projects like this working towards the same
|
|
goal, I think that it would be useful for us to coordinate our efforts
|
|
and produce a single on-going collaborative document that can be used by
|
|
all documentation projects.
|
|
|
|
I don't know whether such a cooperative/collaborative effort is of
|
|
interest to you, but I would very much like to discuss it if it is. I
|
|
think we might be able to attract collaborators from other documentation
|
|
projects (such as the FreeBSD DP and the GNOME DP) for this project if
|
|
it is done as a cooperative effort.
|
|
|
|
Note that the project site is in "first draft" form, and feedback about
|
|
any of it would be appreciated. Bits are subject to change, of course,
|
|
depending on how the project evolves. There's a lot in the "about this
|
|
project" section that might be of interest, particularly regarding the
|
|
development process.
|
|
|
|
- deb
|
|
|
|
--
|
|
deb@thepuffingroup.com
|
|
deb@linuxchix.org
|
|
deb@oswg.org
|
|
|
|
|
|
--
|
|
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="00028" href="msg00028.html">Re: author's guide</a></strong>
|
|
<ul><li><em>From:</em> Gary Lawrence Murphy <garym@canada.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg00024.html">Re: Outline for Author's Guide</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg00026.html">Re: Outline for Author's Guide</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg00023.html">Re: Policy issues</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg00028.html">Re: author's guide</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#00025"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#00025"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|