Add guidance for eventType vs type

iobis / manual

The OBIS manual

https://manual.obis.org/

6 stars 24 forks source link

Add guidance for eventType vs type #92

Closed EliLawrence closed 2 months ago

EliLawrence commented 5 months ago

Current eventType DwC guidelines https://dwc.tdwg.org/terms/#dwc:eventType In the Manual we currently suggest type or eventType. I think it would be good to provide some more guidance on which kinds of standard vocab could be used to fill this field. Happy to hear any suggestions

laurabrenskelle commented 5 months ago

dc:type is a term from Dublin Core that has a controlled vocabulary to describe a resource type. Given this, it should not be used to describe types of events.

timvdstap commented 5 months ago

I agree that it would be good to have some guidance on eventType vs type (vs eventRemarks). A few notes / questions I have around these terms:

If I'm not mistaken, I have seen type being used in the past as an optional term, with free text, often times describing the hierarchy of sampling nature (project, cruise, station, sample, subsample etc). This information would now be included in eventType, right?
I agree with @laurabrenskelle that type should not be used to describe the type of event, but rather the resource type. I'm wondering whether this distinction should more clearly be made in the vocabulary (e.g. resourceType and eventType), especially given that both can be included in the Event core?
I believe eventType is not currently included in the latest version of the IPT: should use eventRemarks instead until this is updated?

tucotuco commented 3 months ago

Darwin Core adopted the Dublin Code term dc:type with its recommended DCMI Type vocabulary. It should not be used for anything other than expressions of type from that vocabulary. As this is an adopted term, it's name, label, and definition are all preserved from the source as a principle.

The Darwin Core term dwc:eventType was ratified in 2023 and included in GBIF's Event and Occurrence schemas since February 2024. Any IPT that does not show this term enabled simply hasn't been updated to the latest schema.

laurabrenskelle commented 2 months ago

Thanks, @tucotuco!

timvdstap commented 2 months ago

Thank you @tucotuco - I have contacted our Node Manager to see if our IPT instance is up to date, or whether there's a different reason I don't see eventType in the schema.

EliLawrence commented 2 months ago

Thanks everyone for the discussion! Indeed I believe type was used in the past for documenting event type. I've updated the manual now to remove the recommendation of type associated with event data, and added eventType usage instead (here: https://manual.obis.org/darwin_core.html#event).

If there's more suggestions or feedback to add clarification let me know otherwise I will close the issue