Skip to content

chore: improve CITATION.cff and add codemeta.json for FAIR4RS compliance#279

Open
siligam wants to merge 3 commits into
mainfrom
chore/findability-improvements
Open

chore: improve CITATION.cff and add codemeta.json for FAIR4RS compliance#279
siligam wants to merge 3 commits into
mainfrom
chore/findability-improvements

Conversation

@siligam

@siligam siligam commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Summary

Improves software citation metadata to better comply with FAIR4RS principles and prepares for listing in the Helmholtz Research Software Directory (RSD).

CITATION.cff

  • Fix message to reference pycmor specifically (was: "ESM-Tools software")
  • Add type: software
  • Add abstract — concise description of what pycmor does
  • Add version: 1.0.2
  • Add license: MIT
  • Add repository-code (distinct from url which now points to the docs)
  • Add keywords (CMOR, CMORization, CMIP6, CMIP7, climate, NetCDF, CF-conventions, WCRP, etc.)

codemeta.json (new file)

  • Full CodeMeta 2.0 metadata file
  • Includes all 4 authors with ORCIDs and AWI affiliation
  • DOI, license, keywords, programming language, funder, CI link, readme link

Why

These metadata files are machine-readable and picked up by:

  • GitHub's "Cite this repository" button
  • Zenodo (on next release)
  • Helmholtz Research Software Directory
  • OpenAIRE and other scholarly infrastructure

Good citation metadata directly supports discoverability and reuse — core FAIR4RS goals.

siligam added 3 commits June 16, 2026 15:24
- CITATION.cff: add type, abstract, version, license, repository-code,
  keywords; fix message to reference pycmor instead of ESM-Tools
- codemeta.json: new file with full CodeMeta 2.0 metadata including
  authors with ORCIDs, DOI, keywords, programming language, and funder
Adds the Software Heritage snapshot identifier
(swh:1:snp:e4d5216be639a8e2dd2be23be1e78981de3fc67d) captured 2026-06-16
to both machine-readable metadata files:
- CITATION.cff: via the identifiers field (type: swh, CFF v1.2.0)
- codemeta.json: expands identifier to array of PropertyValues (doi + swh)
- GitHub Actions workflow triggers SWH save on every published release
  and appends a reminder to the release notes
- Release checklist issue template includes SWHID update as a required step
- scripts/update_swhid.py fetches the latest snapshot SWHID from the SWH
  API and patches CITATION.cff and codemeta.json in-place
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant