Documentation Review of EML RC1: Request for Review

[David Blankman]

EML Release Candidate 1 will be posted on knb.ecoinformatics.org by the 
end of today.

This release still has some unreviewed documentation. We need to have 
all eml-modules reviewed by Thrsday, September 19 in order to have EML 
Relase Candidate 2 posted on Friday, September 20.

Keep in mind that this is technical documentation, not end user 
documentation. The target audience for this documentation is developers 
or people like the LTER information managers not ecology domain scientists.

We need three kinds of help.

1. Taking responsibility for the review of a specific module.
In order to do this you should have both content expertise or, at least, 
content familiarity and eml/xml expertise. Some of the exisiting 
documentation has references to modules that are no longer part of EML, 
so to be responsible you have to have spent enough time with EML to be 
able to catch  references to incorrect terms. Realistically the pool of 
 people who fill these criteria are probably people from NCEAS, CAP, 
NET, Scott Chapel, and probably Tim Bergsma and Ken Ramsey. In addition, 
a person should not be responsible for reviewing documentation that s/he 
has written.

2. GIS related module documentation
. The documentation of modules have been recently added to EML and 
adapted from FGDC (spatialRaster, spatialVector, spatialReference) are 
by everyone's comments sparse and opaque. Anyone who is a GIS expert is 
encouraged to help in this documentation. If you are a GIS expert and 
would like to participate, please email David Blankman 
(dblankman at lternet.edu). I am assembling a team of GIS experts to help 
in this process. Once I hear back from people, we can figure out how to 
divide this up so that the documentation review can proceed efficiently 
and effectively.

3. General Content Review
Anyone with content expertise, or at least content familiarity, is 
encouraged to review modules for both accuracy and readability.

Responsibility Matrix:

ASSIGNED MODULES                PERSON RESPONSIBLE
eml-access                            Scott Chapel 
(scott.chapel at jonesctr.org)              
eml-attribute                          David Blankman 
(dblankman at lternet.edu)
eml-constraint                        Scott Chapel
eml-dataTable                        David Blankman
eml-entity                              David Blankman
eml                                       NCEAS

UNASSIGNED MODULES

eml-coverage
eml-dataset
eml-literature
eml-party
eml-physical
eml-project
eml-protocol
eml-resource
eml-software
eml-storedProcedure (post eml-beta8 addition)
eml-view (post eml-beta8 addition)
 
GIS RELATED MODULES (Please email David Blankman if you have GIS 
expertise and want to participate.)
eml-spatialRaster
eml-spatialReference
eml-spatialVector

People in the "Responsible pool", please list in order your preference 
the modules for which you want to be responsible. As soon as I have 
heard from a critical mass of people, I will resend the responsibility 
matrix.

People who want to do general content review, please send your comments 
to the person who is responsible for a given module's documentation review.

Thank you all in advance for whatever level of participation you choose.



-- 
David E. Blankman
Database Integration Developer
Long Term Ecological Research Network Office
University of New Mexico
801 University, SE #104
Albuquerque, NM 87106
(505) 272-7346 / (505) 272-7080 FAX

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mercury.nceas.ucsb.edu/ecoinformatics/pipermail/eml-dev/attachments/20020913/aa575e5e/attachment.htm