Documentation Review of EML RC1: Request for Review

[Chad Berkley]

I'll start working on coverage.

On Fri, 2002-09-13 at 16:29, David Blankman wrote:
> 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
> 
-- 
-----------------------
Chad Berkley
National Center for 
Ecological Analysis 
and Synthesis (NCEAS)
berkley at nceas.ucsb.edu
-----------------------