RE: [dita] Spec chunking proposal

Doy!

Thanks Jeff.

Michael Priestley, Senior Technical
Staff Member (STSM)

Lead IBM DITA Architect 



http://dita.xml.org/blog/25

"Ogden, Jeff"
<> 

06/26/2009 11:04 AM

To

"dita" <>

cc

Subject

RE: [dita] Spec chunking proposal

This Wiki page has our understanding
from last September about the number of specification documents and what
they would contain:

 

       
        http://wiki.oasis-open.org/dita/Draft_DITA_1.2_Specification_Review_Assignments

 

Back then there were 9 separate
specification documents on the list:

 

The 4 from Michael’s list:

Base Arch Spec

Base Language Reference 

Tech content (combined arch
and language ref)

Learning and training (combined
arch and language ref)

Plus:

       
        Specification Overview (the thing that OASIS
really approves)

       
        Utility Domain Specializations (combined arch
and language ref)

       
        Software and programming (combined arch and
language ref)

       
        Machine Industry (combined arch and language
ref)

       
        Classification, controlled values, and Taxonomies
(arch and language ref)

 

  -Jeff

 

 

From: Michael Priestley [mailto:]

Sent: Friday, June 26, 2009 10:17 AM

To: dita

Subject: [dita] Spec chunking proposal

 

Here's my recall of how we were going to try chunking the specs - basing
it on the DTD/XSD packaging decision here:

http://wiki.oasis-open.org/dita/Draft_list_of_doctype_shells_to_be_included_in_DITA_1.2

So for three doctypes packages, I'm thinking four spec documents:

Base package: 

- architectural spec 

- language spec for topic/map (doctypes/domains listed in package)

Tech content package: 

- single spec, combining arch/overview with language spec for doctypes/domains
in package 

Learning and training package:

- single spec, combining arch/overview with lang spec for doctypes/domains
in package 

Michael Priestley, Senior Technical Staff Member (STSM)

Lead IBM DITA Architect 



http://dita.xml.org/blog/25