OASIS Consortium OASIS Technical Committees OASIS Member Section Program OASIS Info Channels OASIS Newsletters

 
22 January 2003
  UBL Naming and Design Rules Subcommittee (NDR SC)

The purpose of the NDR SC is to recommend to the TC rules and guidelines for normative-form schema design, instance design, and markup naming, and write and maintain documentation of these rules and guidelines.
Announcements
Charter
Membership
Mailing Lists
Documents
Schedule and Minutes
Press

Announcements

26 June 2002

Portal redesign: This portal and the archives have been redesigned to support our ongoing and future volume of work. Old links emanating from external sources should still work for now, but please plan to change links to point into the new archive.

Charter

Our approved charter wording is as follows:

The purpose of the NDR SC is to recommend to the TC rules and guidelines for normative-form schema design, instance design, and markup naming, and write and maintain documentation of these rules and guidelines.

The primary deliverable of the NDR SC is a document that provides the rules and guidelines. Auxiliary deliverables, which may or may not be provided as part of the main document, might include analyses of schema validator feature support and use cases that support our rules and guidelines.

See the Schedule section below for information about specific existing and planned outputs.

Membership

The current members are as follows (quorum is 8):

  • Bill Burcham
  • Mavis Cournane (co-chair, maintainer of this page)
  • Mark Crawford (co-chair, editor)
  • Fabrice Desré
  • Arofan Gregory
  • Jessica Glace
  • Michael Grimley
  • Eduardo Gutentag
  • Eve Maler
  • Sue Probert
  • Lisa Seaburg (co-chair)
  • Gunther Stuhec
  • Paul Thorpe
  • Kris Ketels

Mailing Lists

The ubl-ndrsc list is for use by SC members only. Anyone can view the archive for this list at http://lists.oasis-open.org/archives/ubl-ndrsc.

Comments on NDR outputs should be sent to the ubl-comment list. Anyone can post to this list, as long as they subscribe first. Anyone can view the archive for this list at http://lists.oasis-open.org/archives/ubl-comment.

Documents

The NDR SC maintains several repositories.

  • The current documents repository contains only the most recent and/or active revisions of NDR SC outputs; it provides an ongoing snapshot of our work. Links are provided below to the entire contents of this repository. Consult this repository to review and give feedback on the NDR SC work. Comments on NDR SC outputs should be sent to the ubl-comment@lists.oasis-open.org mailing list (you must subscribe first) using our issues template; fill in columns B through I.

  • The archive holds all versions of all documents produced by the NDR SC.

  • The input repository holds documents prepared by external sources that we have used in our work. A selection of links to various inputs is provided below.

Document identifier Description Status
Current Documents
wd-ublndrsc-ndrdoc-21 ( Word) New! The UBL naming and design rules document. This document has been updated to reflect recent discussions prior to the LCSC 0P70 release.
CodeListModuleTemplate ( XSD) An XSD module demonstrating how to construct datatypes for code lists according to our recommended practice. This is a first draft that initially accompanied revision 12 of the NDR document. We expect to develop the recommendations around documentation fields further soon.
p-stuhec-datetime-05 ( Word) Paper on how to encode dates and times, durations, and periods.
p-gregory-containers-02 ( Word) Paper on when to apply intermediate container elements. This draft is fairly well developed. We are in discussions with the Library Content SC about potential ways to apply it, but have not reached any conclusions even within the NDR SC yet.
draft-burcham-specialization-01 ( zip, PDF, Word) Paper on how to structure complex types in the UBL schemas to support specialization of the sorts needed by the Context Methodology. Includes a description of the "Paella" hybrid proposal. This paper has a lot of good information in it, but recent developments on the Context Methodology may supersede it. Keep an eye on the CM SC portal for more information.
draft-burcham-modnamver-05 (Word) Paper on modularity, namespaces, and versioning of UBL schemas. This paper is active and is nearly up to date, but not entirely so.
p-maler-codelists-09 ( PDF, Word) Paper on how to represent codes from code lists. This paper is frozen. It contains the major parts of the recommendation being made by the NDR SC and its rationales, though further technical development is being done piecemeal on the actual rule text.
draft-stuhec-facets-01 ( PDF, Word) Paper on how to handle simple types in order to ensure that XSD facets can be used. This is an early draft, but we may freeze it here and simply document our (fairly straightforward) recommendations directly in the NDR document.
p-stuhec-OO-Design-01 (Word)Paper on Object Oriented Design. 
draft-gregory-embedded-01.doc WordPaper on Embedded Documentation. 
p-maler-elemreuse-01.doc WordPaper on Element reuse. 
p-larmouth-ubl-asn1-01.doc WordPaper on mapping UBL to ASN1. 
wp-ubl-codelist-01.doc WordNew!White Paper on Naming and Design Rules. 
draft-gertner-urtypesV01.doc WordNew!Paper on Context Methodology Type Model. 
Input Repository
Commerce One modnamver approach
Core Components catalog V1.8
Other Useful External Inputs
W3C test collection initiative
Roger Costello's schema best practices
Kohsuke Kawaguchi's schema dos and don'ts

Schedule and Minutes

We produced our first outputs, consisting of a reviewed document outline and an initial set of position papers to be taken up by the group, by the week of 10 December 2001. Our second output on 17 March 2002 was a set of position papers that is minimally useful for generating schema code from the Library Content SC output. We produced a new/revised set of outputs prior to our 3-7 June 2002 F2F meeting.

NEW! Our current workload through the end of September 2002 involves the following topics. An A priority means we must cover the topic before the next F2F meeting. A B priority means we should try to cover the topic. A C priority means the topic is optional to cover.

    A NDR document improvements (review every two weeks)
     A+ Embedded documentation DONE EXCEPT FOR DOCUMENTING IT
     A Code lists IN PROGRESS
     A Dates and times IN PROGRESS
     A Nested supplementary components
     A Identifier references and whether to pass content by reference
     A- Local vs. global elements
     B+ Containership
     B Updating guiding principles
     B Modnamver URN/schema location
     B Referencing of content, e.g. for attachments
     C Facets
     C Wildcards/open content
     C Nillability
     C Aggregation of similar information for XPath V1.0 addressing

We meet weekly by phone. Calls are held 8:30-10:30am GMT-8 / 11:30am-1:30pm GMT-5 / 5:30-7:30pm GMT+1 on Wednesdays. Calls are open only to members. Please contact one of the chairs if you need call-in information.

Press

See the main UBL page.

 

TOP OF PAGE
Gear Image  
 

ABOUT | MEMBERS | JOIN | NEWS | EVENTS | MEMBERS ONLY | COVER PAGES | XML.org

Copyright © 1993- OASIS ®. All Rights Reserved. OASIS trademark, IPR and other policies apply.