178 lines
5.5 KiB
HTML
178 lines
5.5 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Policy issues -->
|
|
<!--X-From-R13: Yraqnyy Qynex <xpynexNagyht.bet> -->
|
|
<!--X-Date: Sun, 5 Dec 1999 23:47:30 -0500 (EST) -->
|
|
<!--X-Message-Id: 14411.16342.45574.602712@cmpu.net -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Policy issues</title>
|
|
<link rev="made" href="mailto:kclark@ntlug.org">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg00014.html">Date Prev</a>][<a href="msg00016.html">Date Next</a>][<a href="msg00007.html">Thread Prev</a>][<a href="msg00018.html">Thread Next</a>][<a href="maillist.html#00015">Date Index</a>][<a href="threads.html#00015">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Policy issues</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>: Policy issues</li>
|
|
<li><em>From</em>: Kendall Clark <<A HREF="mailto:kclark@ntlug.org">kclark@ntlug.org</A>></li>
|
|
<li><em>Date</em>: Sun, 5 Dec 1999 22:47:18 -0600 (CST)</li>
|
|
<li><em>Reply-to</em>: <A HREF="mailto:kclark@ntlug.org">kclark@ntlug.org</A></li>
|
|
<li><em>Resent-cc</em>: recipient list not shown: ;</li>
|
|
<li><em>Resent-date</em>: 6 Dec 1999 04:47:29 -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>: <NPhab.A.ukC.g_zS4@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>
|
|
All,
|
|
|
|
Ok, the outline I posted included a lot of stuff, some of which isn't
|
|
really "policy" that this committee needs to decide on, so if we are
|
|
gonna work on that stuff together, it should probably be done *after*
|
|
we discuss the policy issues.
|
|
|
|
At Tim's request, I've pulled out what seem to me the chief policy
|
|
issues from the outline. I think his idea, and I agree with it, is
|
|
that this list can form our agenda for discussion. We need to start
|
|
somewhere on the list and just grind out the items. And you thought
|
|
this committee would be fun...
|
|
|
|
Before we actually get into the list though, I'd like it if some of
|
|
you who have used DB -- or other SGML DTDs -- for non-trivial
|
|
documentation projects can look at this policy list and check my
|
|
work. In other words, I think a bit of discussion about the list
|
|
itself is warranted before attacking its items.
|
|
|
|
Anyway, here it is. It's long, but not every item represents an equal
|
|
amount of work; that is, some of these are fairly easy, others
|
|
aren't. So don't get too freaked out by the length, especially since
|
|
it will probably get longer before it gets shorter. <grin type="evil"/>
|
|
|
|
1. Which version(s) of DB?
|
|
2. How/when/why should the LDP "customize" DB, if at all.
|
|
Define a DocBook subset?
|
|
Extend the DB DTD?
|
|
3. I18n issues
|
|
4. Mapping DocBook types to LDP genres
|
|
5. Using Hub Files
|
|
6. Create a DB "stub" document for HOWTOs and Guides:
|
|
Prolog
|
|
Public Identifier
|
|
a Sample Catalog
|
|
7. Discuss Document Reuse issues
|
|
8. Normalization, Validation expectations
|
|
9. Naming Conventions
|
|
file
|
|
titles
|
|
entities
|
|
attributes (especially ID)
|
|
graphics
|
|
10. Entity engineering
|
|
per author
|
|
per document
|
|
define some general entities
|
|
entity submission and entity support
|
|
11. Policy for using marked sections:
|
|
INCLUDE/IGNORE
|
|
CDATA
|
|
12. Common and Role Attribute Usage (
|
|
13. Front and back matter usage
|
|
14. Common Element Usage
|
|
Bold, italics, etc.
|
|
Tables
|
|
Lists
|
|
Links
|
|
Cross References
|
|
Indexing
|
|
Literal Layout
|
|
Address
|
|
Examples
|
|
File, path, and directory names
|
|
15. Policy for using Graphics
|
|
For WWW
|
|
For Print
|
|
acceptable file formats, size constraints, etc.
|
|
16. Rendering Expectations
|
|
WWW
|
|
Print
|
|
|
|
<Kendall/>
|
|
|
|
--
|
|
Homer: Okay, okay, don't panic. To find Flanders, I
|
|
just have to think like Flanders!
|
|
|
|
Homer's Brain:
|
|
I'm a big four-eyed lame-o and I wear the same
|
|
stupid sweater everyday, and --
|
|
|
|
Homer: The Springfield River!
|
|
|
|
Home Sweet Homediddly-Dum-Doodily
|
|
|
|
|
|
--
|
|
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="00018" href="msg00018.html">Re: Policy issues</a></strong>
|
|
<ul><li><em>From:</em> Frederik Fouvry <fouvry@sfs.nphil.uni-tuebingen.de></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="msg00014.html">Re: Outline for Author's Guide</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg00016.html">Re: Outline for Author's Guide</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg00007.html">Hello...</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg00018.html">Re: Policy issues</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#00015"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#00015"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|