Open Geoscience Committee/persistent identifiers pid

From OSGeo
< Open Geoscience Committee
Revision as of 06:52, 9 January 2022 by Gisix (talk | contribs) (→‎Option 1: Upload a snapshot)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Persistent Identifiers (PID): Introduction and HowTo


This wiki page summarizes relevant facts and procedures regarding persistent identifers (PID) for the OSGeo communities.


Draft (2022-01-09)


  1. What are persistent identifiers and why are they relevant
  2. PID for software
  3. PID for people
  4. PID for documentation
  5. PID for video
  6. PID for physical objects
  7. Infrastructure
  8. Howto: Registering a DOI for a OSGeo software Project

What are PID

PID for software

Digital Object Identifier (DOI)

PID for people

Open Researcher and Contributor ID (ORCID)

PID for documentation


PID for video

[page on the TIB AV-Portal]

PID for physical objects



 * Software Repositories (GitHub)
 * Zenodo

Howto: Registering a DOI for a OSGeo software Project


This should be done by a person who represents the software project (member of PSC or similar).


ORCIDs for authors, developers and other project staff can be embedded in the DOI metadata, allowing for proper citation.

Option 1: Upload a snapshot

  • Pro: Takes less than 10 minutes to achieve
  • Pro: Can be extended and superseeded with better integration options. the DOI will stay always valid regardless and will point to the most up to date software version (and author credits)
  • Pro: No need to set webhooks in Zenodo or store description files in GitHub
  • Con: Metadata (author list) must be edited manually. (ORCID option ?)
  • Con: Every software release requires maintenance work by project staff, as an additional tarball must be uploaded and metadata must be updated.



Option 2: Create a live link between the GitHub Repo and Zenodo

  • Pro: Immediate automated updates of DOI payload and metadata for each software release on GitHub
  • Con: Takes a bit longer than option 1 (20 minutes ?)


tbd: Coming real soon