possible bugs in beta9

Chad Berkley berkley at nceas.ucsb.edu
Mon Jul 1 09:00:16 PDT 2002


Hi eml-dev, 

I've been going through and trying to create (by hand) an eml 2.0.0beta9
instance document.  I've found several elements that I think might be
buggy, but I wanted to see what the consensus was.  I've listed them
below.  Please review them and see if you agree with what I say. 

* project/designDescription -- the choice should be between sampling and
(paragraph, citation?) not between (sampling | paragraph | citation).  

* attribute/measurementScale -- this should be optional. 

* attribute/unit -- either this should be optional or we should define
any string value as 'dimensionless' 

* attribute/attributeDomain/enumeratedDomain/codeList -- either the
element codeList should be renamed to codeDef and made repeatable or
another element needs to be added inside of codeList and made
repeatable.  I think it looks sloppy to have something like this: 
<codeList> 
  <code/> 
  <definition/> 
  <source/> 
  <code/> 
  <definition/> 
  <source/> 
</codeList> 

I think it would be better like 
<enumeratedDomain> 
  <codeList> 
    <codeDef> 
      <code/> 
      <definition/> 
    </codeDef> 
    <codeDef> 
      <code/> 
      <definition/> 
    </codeDef> 
  </codeList> 
</enumeratedDomain> 
I just don't like the "element grouping by order" that exists in the
previous example. 

* we should make a new rule about naming elements.  That rule should
state that the parent name does not go in a child element.  It's overly
verbose and redundant to have elements like: 
<attribute> 
  <attributeName/> 
  <attributeLabel/> 
  <attributeDefinition/> 
</attribute> 

It would be much simpler like: 
<attribute> 
  <name/> 
  <label/> 
  <definition/> 
</attribute> 

You already know that it is the name of the attribute simply because
<name> is a child of <attribute>, thus the explicit "attribute" prefix
should be inherited from its parent. 

This is a simple example, but there are much larger examples where the
prefix names get really annoying and take up a lot of space. 


chad 
-- 
-----------------------
Chad Berkley
National Center for 
Ecological Analysis 
and Synthesis (NCEAS)
berkley at nceas.ucsb.edu
-----------------------




More information about the Eml-dev mailing list