search

gbif / tech-docs

This is an integrated technical documentation site for GBIF.org
https://techdocs.gbif.org
0 stars 3 forks source link

Add documentation of GBIF required metadata #100

Open CecSve opened 2 weeks ago

CecSve commented 2 weeks ago

Based on the discussion here https://github.com/gbif/doc-freshwater-data-publishing-guide/issues/20

It is unclear for publishers what is required and not required metadata. There may be differences between EML (or GBIF Metadata Profile) and the IPT's metadata editor interface that should be resolved.

CecSve commented 4 days ago

Perhaps a table specifying what is EML profile required, IPT metadata required, similar to this table. Additional information on what is EML-derived and what are GBIF-specific elements would be nice a well, similar to the logo we add in the definition of this table specifying whether it is a GBIF term or a data standard term.

MattBlissett commented 4 days ago

We need to avoid publishing conflicting information.

There are terms with a strict technical requirement enforced by the data format — an EML document is invalid without them. These are specified in the XSD schema definition in the case of EML / GBIF's EML profile.

There are additional terms where the requirement is enforced by our API or other processing, e.g. licence.

And there are terms where we write that they are required, but there's no technical enforcement of this: https://www.gbif.org/data-quality-requirements-occurrences — occurrenceID, basisOfRecord, scientificName, eventDate.

MattBlissett commented 4 days ago

The GBIF Metadata Profile document could be migrated into the tech docs: https://ipt.gbif.org/manual/en/ipt/latest/gbif-metadata-profile

As it's in the IPT at present, it has complete Spanish and Japanese translations and we don't want to lose these.