Re: [codelist] Guidance sought re: changes for annotations

["Anthony B. Coates (Miley Watts)" <abcoates@mileywatts.com>]

On Thu, 27 Dec 2007 18:01:52 -0000, G. Ken Holman  
<gkholman@CraneSoftwrights.com> wrote:

> At 2007-12-27 17:51 +0000, Anthony B. Coates (Miley Watts) wrote:
>> What genericode does is that the "Annotation/Documentation" elements are
>> used for documentation/description information.
>
> I note in the genericode XSD that the element name is "Description", not  
> "Documentation".

Ouch!  That's a mistake, really.  I meant to copy W3C XML Schema, but I  
also deal with XMI (XML for UML) where both the terms "descriptions" and  
"documentation" get used, and clearly I mixed them up when putting  
together the genericode Schema.  Oh well, it isn't worth changing at this  
late stage.

> Okay ... then following those guidelines, the instance below is what I  
> would have ... where the documentation detail is first and the title and  
> identification pieces of information follow.

My only comment, in looking at the example, is to ask whether "MetaData"  
is a good choice for an element name.  My experience of late is that I get  
a very negative reaction from people when I talk about "metadata".  It's  
too widely misunderstood, and in particular people understand it to mean  
too many different things.  In genericode, the corresponding element is  
called "Identification", and that wouldn't seem to be a bad name here, as  
the metadata seems to mostly be identifying metadata.

Cheers, Tony.
-- 
Anthony B. Coates
Senior Partner
Miley Watts LLP
Experts In Data
UK: +44 (20) 8816 7700, US: +1 (239) 344 7700
Mobile/Cell: +44 (79) 0543 9026
Data standards participant: genericode, ISO 20022 (ISO 15022 XML),  
UN/CEFACT, MDDL, FpML, UBL.
http://www.mileywatts.com/