OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

ubl message

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


Subject: Re: Schema/model bugs


[This is the same message I just sent but with a better subject
line.]

[stephen_green@seventhproject.co.uk:]

| Either way, we would need to update our documentation
| to ensure consistency. We seem to have used both forms
| but I think we've especially favoured 'Unspecialised
| Data Types' (hence abbreviation UDT); I think this
| was to clarify the distinction from xsd:datatypes
| since this had caused some confusion with the understanding
| early on of the CCTS. The edits required in changing back to
| 'Datatypes' might include diagrams and their explanatory text.

Here's my take on where we stand with this.

Variants

   The variants we're looking for are:

      SpecialisedDatatypes
      SpecialisedDataTypes

      UnspecialisedDatatypes
      UnspecialisedDataTypes

      UnSpecialisedDataTypes
      UnspecialisedDataTypes

Diagrams

   The only artwork that I've checked into the fcs image that
   contains any of these terms is

      ./art/UBL-1.0-ModelDependency.gif

   and it spells these out as "Specialised Data Types" and
   "Unspecialised Data Types" (with spaces).  I'm still waiting a
   revised version of the schema assembly diagram, so we just need
   to make sure that it uses the forms we decide on.

Explanatory text

   Editing the text to make sure it's consistent is my problem;
   don't worry about it.

Spreadsheets

   As far as I can tell, none of the variants appear in the
   content of any of the spreadsheets, only in a couple of the
   file names:

      ./mod/common/UBL-SpecialisedDataTypes-draft-12.xls
      ./mod/common/UBL-UnSpecialisedDataTypes-draft-12.xls

Schemas and instances

   The variants using "Datatype" appear in schema file names and
   in the content of both schemas and instances.

Details

   A detailed comparison of the occurence of each variant appears
   below.  From this it can be seen that there are a lot more
   files that have "Datatypes" than have "DataTypes," but these
   are all xsd and xml files that are trivial to change in batch
   mode (I could do this in about fifteen minutes).

Recommendation

   My own inclination is to make it "DataTypes" (or "Data Types"
   in text) throughout simply because "data" and "type" are
   English words and "datatype" is not.  Let's pick this up in the
   joint SC meeting tomorrow (Tuesday 6 April 8 a.m. San Francisco
   daylight time).  I'll be glad to make this change to the schema
   and instance files if this is all that's needed.

Jon

##################################################################

1A. SpecialisedDatatypes

    Found in file name:

       ./xsd/common/UBL-SpecialisedDatatypes-1.0-draft-12.1.xsd

    Found in text:

       ./xml/joinery/UBL-DespatchAdvice-1.0-Joinery-Example.xml
       ./xml/joinery/UBL-Invoice-1.0-Joinery-Example.xml
       ./xml/joinery/UBL-Order-1.0-Joinery-Example.xml
       ./xml/joinery/UBL-OrderResponse-1.0-Joinery-Example.xml
       ./xml/office/UBL-Invoice-1.0-Office-Example.xml
       ./xml/office/UBL-Order-1.0-Office-Example.xml
       ./xml/office/UBL-OrderCancellation-1.0-Office-Example.xml
       ./xml/office/UBL-OrderChange-1.0-Office-Example.xml
       ./xml/office/UBL-OrderResponseSimple-1.0-Office-Example.xml
       ./xml/office/UBL-ReceiptAdvice-1.0-Office-Example.xml
       ./xsd/common/UBL-CommonAggregateComponents-1.0-draft-12.1.xsd
       ./xsd/common/UBL-CommonBasicComponents-1.0-draft-12.1.xsd
       ./xsd/common/UBL-SpecialisedDatatypes-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-DespatchAdvice-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-Invoice-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-Order-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-OrderCancellation-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-OrderChange-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-OrderResponse-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-OrderResponseSimple-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-ReceiptAdvice-1.0-draft-12.1.xsd

1B. SpecialisedDataTypes

    Found in file names:

       ./mod/common/UBL-SpecialisedDataTypes-draft-12.xls
       ./mod/common/UBL-UnSpecialisedDataTypes-draft-12.xls

    Found in text:

       none

##################################################################

2A. UnspecialisedDatatypes

    Found in file names:

       ./xsd/common/UBL-UnspecialisedDatatypes-1.0-draft-12.1.xsd

    Found in text:

       ./xml/joinery/UBL-DespatchAdvice-1.0-Joinery-Example.xml
       ./xml/joinery/UBL-Invoice-1.0-Joinery-Example.xml
       ./xml/joinery/UBL-Order-1.0-Joinery-Example.xml
       ./xml/joinery/UBL-OrderResponse-1.0-Joinery-Example.xml
       ./xml/office/UBL-DespatchAdvice-1.0-Office-Example.xml
       ./xml/office/UBL-Invoice-1.0-Office-Example.xml
       ./xml/office/UBL-Order-1.0-Office-Example.xml
       ./xml/office/UBL-OrderCancellation-1.0-Office-Example.xml
       ./xml/office/UBL-OrderChange-1.0-Office-Example.xml
       ./xml/office/UBL-OrderResponseSimple-1.0-Office-Example.xml
       ./xml/office/UBL-ReceiptAdvice-1.0-Office-Example.xml
       ./xsd/common/UBL-CommonAggregateComponents-1.0-draft-12.1.xsd
       ./xsd/common/UBL-CommonBasicComponents-1.0-draft-12.1.xsd
       ./xsd/common/UBL-SpecialisedDatatypes-1.0-draft-12.1.xsd
       ./xsd/common/UBL-UnspecialisedDatatypes-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-DespatchAdvice-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-Invoice-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-Order-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-OrderCancellation-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-OrderChange-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-OrderResponse-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-OrderResponseSimple-1.0-draft-12.1.xsd
       ./xsd/maindoc/UBL-ReceiptAdvice-1.0-draft-12.1.xsd

2B. UnspecialisedDataTypes

    Found in file name:

       none

    Found in text:

       none

##################################################################

3A. UnSpecialisedDataTypes

    Found in file name:

       ./mod/common/UBL-UnSpecialisedDataTypes-draft-12.xls

    Found in text:

       none

3B. UnspecialisedDataTypes

    Found in file name:

       none

    Found in text:

       none

##################################################################




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