Thank you, Steve, this is awesome!

I took a stab at the Abstract and the Use of Terms, please see below and edit freely:

Abstract
"The Humboldt Extension for Ecological Inventories provides a standardized vocabulary to report key information about biodiversity inventories maximizing the usability and interoperability of these data. This vocabulary is employed along with the Darwin Core (DwC) terms, effectively broadening the scope of dwc:Event records by incorporating terms absent from the main DwC vocabulary. Terms included in the extension are defined such that they can accommodate hierarchical data structures allowing the representation of complex, highly nested survey designs. This document lists all terms currently used in the vocabulary providing comments and examples of their usage along with ancillary documents that provide guidance on the use and interpretation of  terms and the data structure needed to accommodate dwc:Event hierarchies frequently observed in ecological inventories."

Do we need to define ecological/biodiversity inventories here?

Use of terms
"The terms in this extension are meant to provide stable definitions that can be used in a variety of biodiversity inventory contexts but were envisioned principally to function together as an extension to Darwin Core. This vocabulary allows the reporting of detailed information about the inventory process such as i) a general description of the survey, ii) where an inventory takes place and the habitat characteristics and environmental conditions of survey sites, ii) when an inventory takes place, iii) the target taxonomic group, life stages, growth forms, and degrees of establishment of the organisms sampled, iv) the methodology implemented (inventory type performed, protocol(s) used, absence reported, material samples or vouchers collected, non-target taxa reported), and v) the completeness of the inventory and the sampling effort applied. This extension allows the representation of complex, highly nested survey designs, an ancillary document explaining how dwc:Event hierarchies for ecological inventories should be structured and providing guidance on the use of the terms in the context of parent and child dwc:Event(s) can be found [add link]. To assist in the interpretation of the term eco:isLeastSpecificTargetCategoryQuantityInclusive a detailed description of its use is provided [add link]"


Virus-free.www.avast.com

On Thu, Aug 24, 2023 at 3:44 PM Baskauf, Steven James <steve.baskauf@vanderbilt.edu> wrote:

Hi all,

 

I have finish converting the list of terms header document from static Markdown to a template (https://github.com/tdwg/hc/blob/main/build/termlist-header.md). So now all of the document metadata gets inserted from the same source as is used to generate the machine-readable metadata about the document.

 

The practical implication of this is that the List of Terms document (https://tdwg.github.io/hc/list/) now displays contributor names and affiliations. The name is hyperlinked to the ORCID record and the affiliation is linked to the Wikidata page for the institution (or the closest thing I could come up with that was in Wikidata).

 

So please check this out by clicking on your links.

 

Once the abstract is finished, I will add it to the general document metadata (https://github.com/tdwg/rs.tdwg.org/blob/eco/process/document_metadata_processing/eco_doc_list/document_configuration.yaml) so that it will be picked up as machine readable in addition to being inserted in this doc.

 

There is still one thing missing from the List of Terms, and that is section 2, “Use of Terms”. Somebody needs to write something for that. For comparison, see some examples like the Chrono extension https://tdwg.github.io/chrono/list/ , the establishmentMeans vocab https://dwc.tdwg.org/em/, and the “categories of terms” section 1.2 for Audiovisual Core https://ac.tdwg.org/termlist/. Basically, we need to imagine that this page is the only thing that people could see about the terms. What would they need to know? It would be appropriate to tell them about the two other standards docs we are creating that explain how to use the terms.

 

Steve

 

-- 

Steven J. Baskauf, Ph.D.  he/him/his

Data Science and Data Curation Specialist / Librarian III

Jean & Alexander Heard Libraries, Vanderbilt University

Nashville, TN 37235, USA

 

Biodiversity Information Standards (TDWG) Executive Committee/Technical Architecture Group Chair

https://baskauf.github.io/

 

_______________________________________________
tdwg-humboldt mailing list
tdwg-humboldt@lists.tdwg.org
https://lists.tdwg.org/mailman/listinfo/tdwg-humboldt