Update on documentation Review

[dblankman@lternet.edu]

Quoting Chad Berkley <berkley at nceas.ucsb.edu>:

Modules New Assignments (Volunteered)
eml-physical   Owen Eddins
eml-project    Tim Bergsma
eml-protocol   Tim Bergsma
eml-literature Corinna Gries
eml-software   Corinna Gries
eml-coverage   Chad Berkeley
eml-dataset    chad or Scott
spatialRaster, spatialVector,spatialReference   Ken Ramsey(first level)
> 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
> -----------------------
> 
>