RE: [ubl] [OASIS Issue Tracker] (UBL-11) Revision Methodology as a Committee Note

["G. Ken Holman" <gkholman@CraneSoftwrights.com>]

At 2015-03-03 12:24 +0000, Duvekot, Kees wrote:
> One point that was a bit confusing and what might be difficult for 
> people outside of UBL to understand was the Appendix C.

This morning I also see a typographical layout issue in that the 
first bolded heading is improperly set as a list item.  In fact, some 
indentation or subsections would be useful to visually distinguish 
ABIEs, BBIEs and ASBIEs.

> Maybe we can make that better understandable when we include some 
> samples of a very simple structure (not sure what the smallest is we 
> have) so that people can also relate it back to the XSD's etc.

Another thought that has been expressed is that it be removed 
entirely, as the guide to the terminology has no valuable role in a 
document of this kind, nor does it serve the anticipated audience of 
this document.  After all, 
http://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.html#A-THE-UBL-2.1-DATA-MODEL 
has the same information, complete with examples.

Although Annex D is similarly technical, such direction is not 
provided in the UBL specification and so I would not support removing 
that annex.

Would you support removing the existing Annex C and replacing the 
fourth paragraph of 4.4 with the following paragraph:

http://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.html#A-THE-UBL-2.1-DATA-MODEL 
contains useful information about the data modeling concepts used in UBL.

I can republish the documents and revise the agenda motions to refer 
to the changed documents.

Any thoughts from anyone else in this regard before I make changes?

. . . . . . . Ken


--
Check our site for free XML, XSLT, XSL-FO and UBL developer resources |
Free 5-hour lecture:  http://www.CraneSoftwrights.com/links/video.htm |
Crane Softwrights Ltd.             http://www.CraneSoftwrights.com/o/ |
G. Ken Holman                    mailto:gkholman@CraneSoftwrights.com |
Google+ profile:       http://plus.google.com/+GKenHolman-Crane/about |
Legal business disclaimers:     http://www.CraneSoftwrights.com/legal |


---
This email has been checked for viruses by Avast antivirus software.
http://www.avast.com