OASIS Darwin Information Typing Architecture (DITA) TC

 View Only

Re: [dita] Groups - Suggested updates for 1.0 specification (suggestedUpdates.html) uploaded

  • 1.  Re: [dita] Groups - Suggested updates for 1.0 specification (suggestedUpdates.html) uploaded

    Posted 05-27-2005 21:50
     MHonArc v2.5.0b2 -->
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    dita message

    [Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


    Subject: Re: [dita] Groups - Suggested updates for 1.0 specification (suggestedUpdates.html) uploaded


    Hi Chris,
    
    You're right that the file is catalog-dita.xml, not catalog.xml. In the
    copy I got from here:
    http://www.oasis-open.org/committees/download.php/12091/cd2.zip
    inside the dtd.zip package, the file catalog-dita.xml contains this line:
      <public publicId="-//OASIS//ENTITIES DITA Topic Class//EN"
              uri="topicAttr.ent"/>
    The file included with that package is actually topicAttr.mod. The
    architecture spec says topicAttr.mod is correct.
    
    For the ut-d-simpletable entity - Don says that when he applied the OASIS
    changes, he started with dita132 files in which he forgot he had been
    toying with a specialization.  He says that's why I've got the DTD job now.
    :-)
    
    Thanks for the hilightDomain correction.
    
    For Property - any suggestions? My primary reason for the change was so
    that a user reading through the DTD would not expect it to be a
    phrase-level element. If we don't want to include the presentation info, we
    can leave it as Property.
    
    Thanks for the programmingDomain correction.
    
    Since posting the list, I have found one other comment problem. The
    topic.mod file says that it contains declarations "..for the Programming
    Domain." This should be updated to "...for the base Topic type."
    
    Thanks,
    
    Robert D Anderson
    IBM Authoring Tools Development
    Chief Architect, DITA Open Source Toolkit
    
    
                                                                               
                 Christopher Wong                                              
                 <cwong@idiominc.c                                             
                 om>                                                        To 
                                           Robert D                            
                 05/24/2005 09:43          Anderson/Rochester/IBM@IBMUS        
                 AM                                                         cc 
                                           dita@lists.oasis-open.org           
                                                                       Subject 
                                           Re: [dita] Groups - Suggested       
                                           updates for 1.0 specification       
                                           (suggestedUpdates.html)   uploaded  
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
    
    
    
    
    I agree with just about all the suggested updates.
    
    Comments on the suggested updates:
          mentions a typo in "catalog.xml". Is there such a file? The closest I
          see is catalog-dita.xml, and it does not have the typo in question.
          remove entity declaration for "ut-d-simpletable" from
          utilitiesDomain.ent: could you give some background?
          hilightDomain.mod: typo, I think. Should be "highlightDomain.mod".
          <property> in reference.mod should be described as "Property Row",
          not "Property". Maybe we could have a better name? The suggested long
          name seems to mix presentation with semantic.
          "sepcialization" typo in topic.mod: programmingDomain.mod also has
          the same typo.
    Sorry for the late notice.
    
    Chris
    
    robander@us.ibm.com wrote:
          The document named Suggested updates for 1.0 specification
          (suggestedUpdates.html) has been submitted by Mr. Robert Anderson to
          the
          OASIS Darwin Information Typing Architecture (DITA) TC document
          repository.
    
          Document Description:
          The suggested changes correct a couple of technical problems in the
          specification, as well as suggesting numerous corrections to comments
          in
          the DTD and XSD files. The suggested changes are grouped roughly by
          type,
          with general changes first (including all technical problems),
          followed by
          incorrect element descriptions, typos, and entity issues.
    
          View Document Details:
          http://www.oasis-open.org/apps/org/workgroup/dita/document.php?document_id=12665
    
    
          Download Document:
          http://www.oasis-open.org/apps/org/workgroup/dita/download.php/12665/suggestedUpdates.html
    
    
    
          PLEASE NOTE:  If the above links do not work for you, your email
          application
          may be breaking the link into two pieces.  You may be able to copy
          and paste
          the entire link address into the address field of your web browser.
    
          -OASIS Open Administration
    
    
    


    [Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]