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

[Robert D Anderson <robander@us.ibm.com>]

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