[Bug 492] - eml-literature changes needed

[bugzilla-daemon@ecoinformatics.org]

http://bugzilla.ecoinformatics.org/show_bug.cgi?id=492

jones at nceas.ucsb.edu changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |ASSIGNED



------- Additional Comments From jones at nceas.ucsb.edu  2002-08-30 14:37 -------
Completed revisions to eml-literature.  Here's a review of what I did (there's a
special surprise at the end :)...

a.
Drop section from book

DONE

b.
Drop editors from edited book

DONE

c.
Add bookChapter or bookSection

Added Chapter complex type and "chapter" element as a reference type.

d.
Drop conference proceedings. If these are published, then they are a 
book. The information about the event and venue is part of the title.

DID NOT DROP IT.  Kept it to maintain compatibility with EndNote.  It extends
book chapter and adds the few fields needed for the EndNote
conferenceProceedings type.

e.
Drop publicationPlace – the locational information is already in 
publisher

KEPT it.  Publication place may very well differ fromthe mailing address of the
publisher.  The address in RP seemed like an inappropriate place to me to put
the publicationPlace.  I did, however, convert this to a string, as a
"publicationPlace" itself can in no way be construed to be a person,
organization, or role (which is what RP represents).

f.
Drop presentationPlace. Move the proceedings information from 
conferenceProceedings to this module.

PRESENTATION type dropped altogether.  No corresponding type in EndNote.
  
g.
Drop institution from report. Institutional affiliation of authors is 
already in the RP information of the authors.

Kept it.  Again, the address of the authors may not correspond with the
institution sponsoring the report.  For example, many SFI reports would have
"Santa Fe Institute" as the institution, but the authors are not from SFI.  Same
could go for NCEAS, or NSF, etc.

h.
Make report number optional. This may be part of the title or non-
existent

DONE.

i.
Drop publisher from thesis. If it is published then it is a book.

DONE.

j.
Drop software package. This is covered under eml-software

DONE. it was gone before.

k.
Drop the unnecessary sequence element containing access and project.

DONE. project is gone.

In addition to these changes that were suggested above, I also had an epiphany
and went for it...  I made each of the reference types include the ResourceGroup
directly, rather than having ResourceGroup be part of CitationType.  This is
minorly more verbose in the schema, but makes much more sense in instance
documents because all of the fields of a reference are included inside of the
type element, like this...

<citation>
  <article>
    <title>fake title</title>
    <creator>...</creator>
    ...
    <journal>Ecology</journal>
    ...
  </article>
</citation>

I personally think this is much cleaner and more understandable than before.

Finally, I reworked the documentation for the whole module, created a test
instance documented, and verified that everything validates under the schema
using "ant test".  I think this takes care of all outstanding issues with
eml-literature.  Will someone review it please? Thanks.