Clarification and examples for related_products

[rduyme]

https://skg-if.github.io/interoperability-framework/docs/research-product.html#related_products

Request 1 : There is a need to explain related_products link types with examples. Could we add a section for each type ?

'literature'

• "cites" :
  • https://doi.org/10.1038/sdata.2016.18 cites https://doi.org/10.1371/journal.pbio.1002295 (crossref example)
• "is_supplemented_by" :
  • https://doi.org/10.5281/zenodo.14859554 is_supplemented_by https://doi.org/10.5281/zenodo.13646487 (datacite example)
  • https://doi.org/10.1038/s41586-020-2149-4 is_supplemented_by "pdf URL" (crossref example)
• "is_documented_by" : n/a ?
• "is_new_version_of" : n/a ? only 186 records on Datacite
• "is_part_of" : ?

'data'

• "cites" : n/a ?
• "is_supplemented_by" : ? Do we expect a literature publication link here ? "Data Availability" section ?, data "is_cited_by" pub ?
• "is_documented_by" : ? Same question as above "is_supplemented_by"
• "is_new_version_of" : https://doi.org/10.5281/zenodo.14851262 is_new_version_of https://doi.org/10.5281/zenodo.14582029
• "is_part_of" : ?

'software'

• "cites" : n/a ?
• "is_supplemented_by" : ? ex: software presentation ?
• "is_documented_by" : ? ex: software doc ?
• "is_new_version_of" : ? https://doi.org/10.5281/zenodo.14191232 is_new_version_of https://zenodo.org/records/14191233
• "is_part_of" : ?

Request 2 : Could we append the following text to the description.
"cites" means any type of relation defined in "CiTO, the Citation Typing Ontology"  https://sparontologies.github.io/cito/current/cito.html#objectproperties

Resources :

• Datacite relation types list (IsNewVersionOf, Cites...) : https://datacite-metadata-schema.readthedocs.io/en/4.5/appendices/appendix-1/relationType/
• Datacite queries to find examples :
  • https://api.datacite.org/dois?query=relatedIdentifiers.relationType:IsNewVersionOf%20AND%20publisher:Zenodo%20AND%20types.resourceTypeGeneral:Dataset
  • https://api.datacite.org/dois?query=relatedIdentifiers.relationType:IsNewVersionOf%20AND%20types.resourceTypeGeneral:Dataset
• Note on Datacite versioning : https://support.datacite.org/docs/versioning

When content underlying a DOI is updated, we recommend updating the DOI metadata and, for major changes, assigning a new DOI.
    For minor content changes, the same DOI may be used with updated metadata. A new DOI is not required.
    For major content changes, we recommend assigning a new DOI and linking the new DOI to the previous DOI with related identifiers.

• Zenodo query : https://zenodo.org/api/records?q=doi:%2210.5281/zenodo.14859555%22

Questions

• "is_part_of" examples I found on datacite zenodo are datasets linked to "zenodo communities" ex: https://api.datacite.org/dois/10.5281/zenodo.830511. Why do we have "is_part_of" in SKG-IF ?

• It seems there was decision to remove "references" and only keep "cites" ( I supposed based on this : https://support.datacite.org/docs/contributing-citations-and-references )

[alen-vodopijevec-cessda]

@rduyme .. can we add "IsCitedBy" to "relatedProducts"?

We need this identifier to list publications that cite datasets we're exposing via skg-if endpoint