OASIS Darwin Information Typing Architecture (DITA) TC

 View Only
  • 1.  Feature Request: Make tgroup optional w/in table

    Posted 03-02-2007 20:49
    I am creating documents from legacy where all the tables are being used 
    by reference.
    
    Because tgroup is required w/in table, it means that all my conrefs look 
    like this:
    
    
    Which seems a little silly. Cheers, Eliot -- W. Eliot Kimber Professional Services Innodata Isogen 8500 N. Mopac, Suite 402 Austin, TX 78759 (214) 954-5198 ekimber@innodata-isogen.com www.innodata-isogen.com


  • 2.  Re: [dita] Feature Request: Make tgroup optional w/in table

    Posted 03-03-2007 04:27
    The story seems related to the choice of the OASIS XML Exchange Table Model
    as the definitive version for DITA.
    http://www.oasis-open.org/specs/tm9901.html
    
    In that default DTD, the content model for table is effectively:
    
    
    
    
    ...
    
    
    In the DITA adaptation, the equivalent specialization-enabled declaration
    is:
    
    
    
    
    ...
    
    
    Thus, tgroup effectively remains one or more by inheritance from the
    Exchange Table Model.  Due to the wide use of this model across most XML
    DTDs that use tables, we are sort of faced with either changing this design
    uniquely for DITA, or with pushing the Why question back to the framers of
    the 1999 document.  With my DITA specialization hat on, I can see the
    rationale of your request. With my Chair hat on, I worry what impact such
    change might have on editor implementations that may have somehow built
    dependencies on the requiredness of tgroup (ensuring that new tables get a
    default setup when created, perhaps) in which the relaxation might affect
    how usability is perceived.
    
    Regards,
    --
    Don Day
    Chair, OASIS DITA Technical Committee
    IBM Lead DITA Architect
    Email: dond@us.ibm.com
    11501 Burnet Rd. MS9033E015, Austin TX 78758
    Phone: +1 512-838-8550
    T/L: 678-8550
    
    "Where is the wisdom we have lost in knowledge?
     Where is the knowledge we have lost in information?"
       --T.S. Eliot
    
    
                                                                               
                 "W. Eliot Kimber"                                             
                 


  • 3.  RE: [dita] Feature Request: Make tgroup optional w/in table

    Posted 03-03-2007 23:24
    This isn't really an OASIS table issue.  It's a conref issue.
    
    The problem arises whenever you conref to an element whose
    content model doesn't allow it to be empty.  The problem is
    just due to the basic definitions of XML and DITA's conref.
    Basically, the design of DITA's conref is not completely
    compatible with XML.
    
    We could allow DITA's table element to be empty--and assume
    this situation would only be used in the conref case--but if 
    the table element is not empty, tgroup needs to be required.
    
    paul 
    
    > 


  • 4.  RE: [dita] Feature Request: Make tgroup optional w/in table

    Posted 03-05-2007 15:19
    I concur with Paul: this isn't a table issue, but a conref issue. 
    
    This basically means that you cannot resolve the issue by dinkering with
    the table's content model, because this issue arises with ANY element
    that has mandatory children. You cannot conref to a topic or a task or a
    task step without adding mandatory child elements.  You also cannot
    resolve this issue by going through every single standard DITA element
    and relaxing its content model to make all its children optional,
    because specialization allows you to add additional restrictions (like
    mandatory children). You'd have to change not only all standard DITA
    elements, but also all future and possible specializations.
    
    I suggest we continue to leave this issue to be handled by editor
    implementations. Idiom's implementation creates conrefs by inserting
    mandatory child elements, ensuring validity, and I'm sure others do the
    same thing. Since DITA users tend to use WYSIWYG editors, I don't see
    the "extra" elements being an issue. It's just inelegant from the
    perspective of someone viewing the raw XML source.
    
    Chris