161 lines
5.4 KiB
HTML
161 lines
5.4 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: SGML and Docbook documentation -->
|
|
<!--X-From-R13: [nex Oyyra <gpgqcNlnubb.pbz> -->
|
|
<!--X-Date: Sun, 25 Jun 2000 23:38:12 -0400 (EDT) -->
|
|
<!--X-Message-Id: 20000626033803.25490.qmail@web4904.mail.yahoo.com -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>SGML and Docbook documentation</title>
|
|
<link rev="made" href="mailto:tctdp@yahoo.com">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg03024.html">Date Prev</a>][<a href="msg03026.html">Date Next</a>][<a href="msg04237.html">Thread Prev</a>][<a href="msg03027.html">Thread Next</a>][<a href="maillist.html#03025">Date Index</a>][<a href="threads.html#03025">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>SGML and Docbook documentation</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: LDP Discussion Group <<A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A>></li>
|
|
<li><em>Subject</em>: SGML and Docbook documentation</li>
|
|
<li><em>From</em>: Mark Allen <<A HREF="mailto:tctdp@yahoo.com">tctdp@yahoo.com</A>></li>
|
|
<li><em>Date</em>: Sun, 25 Jun 2000 20:38:03 -0700 (PDT)</li>
|
|
<li><em>Resent-date</em>: Sun, 25 Jun 2000 23:38:12 -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>: <kjrWUC.A.jH.2AtV5@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>
|
|
Thanks for your quick responses from Hugo van der
|
|
Kooij and Martin Wheeler to my recent inquiry about
|
|
SGML and Docbook. Sorry I forgot to include a
|
|
subject.
|
|
|
|
I did realize that SGML was used to define other
|
|
markup languages but did not realize there were so
|
|
many of them. You gave me a lot of good information
|
|
that I will check into.
|
|
|
|
Martin Wheeler's respones to my question:
|
|
Welcome to the LDP.
|
|
Would you like to start documenting DocBook methods
|
|
straight away?
|
|
This group needs it.
|
|
|
|
I am willing to work on documenting this and document
|
|
SGML in general to the extent that readers can get the
|
|
big picture and understand some background about the
|
|
various developments with SGML and SGML derived DTDs.
|
|
I will work on documenting the fact that SGML is so
|
|
generic since I don't think this is immediately
|
|
obvious and is confusing to those trying to learn the
|
|
technology. I will also try to document the use of
|
|
some of the tools involved but cannot guarantee to
|
|
document them all. Do I need to register with the LDP
|
|
to do this?
|
|
|
|
My Question:
|
|
> If a documented method can
|
|
> be established for all writers to have enough "ease
|
|
of
|
|
> use" with Docbook I would be willing to work with
|
|
> various individuals and organizations such as the
|
|
LDP
|
|
> and OASIS to try to make it a standard for the
|
|
> industry as much as is practical.
|
|
|
|
Your response:
|
|
Difficult. But go ahead, certainly. Various
|
|
industries, large
|
|
publishers, medical organisations, the military, etc.
|
|
have long had
|
|
their own DTDs specifically written for them, to cover
|
|
their own
|
|
specific tech-doc requirements, and are unlikely to
|
|
change.
|
|
Competent tech-doc writers just learn a new DTD,
|
|
rather than try to
|
|
persuade all employers to dance to the same tune.
|
|
|
|
This makes me concerned about the direction the
|
|
industry is headed with reguard to documentation. Is
|
|
it easy for writers to change from one type to
|
|
another? It seems to me that this would cause more
|
|
confusion and that it would be better to settle on at
|
|
least a general standard. I think OASIS recommends
|
|
Docbook and I'm sure the LDP would not use Docbook if
|
|
it were not good, but what are its advantages and
|
|
disadvantages over some of the other types?
|
|
|
|
Thanks for your help.
|
|
|
|
Mark Allen
|
|
|
|
|
|
__________________________________________________
|
|
Do You Yahoo!?
|
|
Get Yahoo! Mail - Free email you can access from anywhere!
|
|
<A HREF="http://mail.yahoo.com/">http://mail.yahoo.com/</A>
|
|
|
|
|
|
--
|
|
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>
|
|
<ul><li><strong>Follow-Ups</strong>:
|
|
<ul>
|
|
<li><strong><a name="03027" href="msg03027.html">Re: SGML and Docbook documentation</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="msg03024.html">LTH [Was: HOWTOs in DocBook SGML?]</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg03026.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg04237.html">Re: about accepted formats (Re: Simplified DocBook)</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg03027.html">Re: SGML and Docbook documentation</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#03025"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#03025"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|