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

[Christopher Wong <cwong@idiominc.com>]

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
>
>  
>