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-31-2005 14:22
     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


    Thanks for clarifying the catalog issue: I must have misunderstood the 
    problem description.
    
    On the <property> long name, I would prefer to leave the description 
    as-is. Describing its appearance in a DTD comment seems premature, 
    especially since the language reference is noncommital on a <properties> 
    element's final appearance ("the typical rendering is usually a 
    table-like format"). In any case, I don't feel particularly strongly 
    about this, since it seems nobody cares about comments in DTDs (which is 
    why the TC collectively let so many typos through!). It's a good thing 
    that somebody is paying attention to these things. If you feel strongly 
    that it should use the longer description, I won't throw a fit.
    
    Chris
    
    Robert D Anderson wrote:
    
    >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]