OASIS Darwin Information Typing Architecture (DITA) TC

  • 1.  Spec chunking proposal

    Posted 06-26-2009 14:17 

    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
    
mpriestl@ca.ibm.com
    
http://dita.xml.org/blog/25


  • 2.  RE: [dita] Spec chunking proposal

    Posted 06-26-2009 15:05 
    










    


    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:mpriestl@ca.ibm.com]
    
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
    
mpriestl@ca.ibm.com
    
http://dita.xml.org/blog/25


  • 3.  RE: [dita] Spec chunking proposal

    Posted 06-26-2009 15:11 

    Doy!

    Thanks Jeff.

    Michael Priestley, Senior Technical
Staff Member (STSM)
    
Lead IBM DITA Architect
    
mpriestl@ca.ibm.com
    
http://dita.xml.org/blog/25


    

    

    
"Ogden, Jeff"
<jogden@ptc.com> 

    06/26/2009 11:04 AM

    		

    

    


    To
    
    		"dita" <dita@lists.oasis-open.org>

    


    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:mpriestl@ca.ibm.com]

    
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
    
mpriestl@ca.ibm.com
    
http://dita.xml.org/blog/25


Related Content