Policy issues

[Kendall Clark <kclark@ntlug.org>]

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