From 87be7d7e77e7bee9b583e9e4ccfa2893fafec9f5 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 27 Sep 2026 12:09:08 +0000 Subject: [PATCH] Record the Zenodo DOI for dataset v0.4.0 10.5281/zenodo.22996479, now in data/dataset-meta.json, CITATION.cff, the Data Package descriptor (id), the atlas JSON-LD (identifier), the README (badge and citation) and the About page citation. The release-dataset skill documents where a new DOI goes after each release. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_0134nrWUakNL58qJMzCVDcn6 --- .claude/skills/release-dataset/SKILL.md | 7 +++++-- CHANGELOG.md | 7 +++++++ CITATION.cff | 8 ++++++++ README.md | 7 ++++--- about.html | 4 ++-- data/datapackage.json | 1 + data/dataset-meta.json | 6 ++++++ index.html | 1 + scripts/build-data.mjs | 1 + 9 files changed, 35 insertions(+), 7 deletions(-) diff --git a/.claude/skills/release-dataset/SKILL.md b/.claude/skills/release-dataset/SKILL.md index 765b52a..f8378f4 100644 --- a/.claude/skills/release-dataset/SKILL.md +++ b/.claude/skills/release-dataset/SKILL.md @@ -30,5 +30,8 @@ description: Cut a new Mapping Voices dataset version — bump the version every `v` automatically (notes from the CHANGELOG section, via `scripts/release-notes.mjs`). With the Zenodo–GitHub integration on, Zenodo archives it and mints a DOI (metadata in `.zenodo.json`). Once the - user reports the DOI, add it to CITATION.cff (`doi:` / `identifiers`), - the README citation, and the About page citation. + user reports the DOI, update `data/dataset-meta.json` → `doi` + (version, doi, url), CITATION.cff (`doi:` / `identifiers`), the README + badge and citation, the About page citation, and the `identifier` in the + index.html JSON-LD; then `node scripts/build-data.mjs`. The release + workflow re-runs on that commit and does nothing (the release exists). diff --git a/CHANGELOG.md b/CHANGELOG.md index ff4d23e..d07937f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,13 @@ broken-source changes, and taxonomy changes (METHODOLOGY §10, §12). ## [Unreleased] +### Dataset +- v0.4.0 is archived on Zenodo with DOI + [10.5281/zenodo.22996479](https://doi.org/10.5281/zenodo.22996479); the + DOI is recorded in `data/dataset-meta.json` (`doi`), `CITATION.cff`, the + Data Package descriptor (`id`), the atlas JSON-LD, the README (badge and + citation), and the About page citation. + ### Tooling - `.github/workflows/release.yml` creates a GitHub release `v` whenever the dataset version changes on `main` (or on demand), with diff --git a/CITATION.cff b/CITATION.cff index 82b41bd..01c9036 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -7,6 +7,14 @@ message: >- title: "Mapping Voices: An Open Atlas of Oral-History and Voice-Testimony Collections" type: dataset version: 0.4.0 +doi: 10.5281/zenodo.22996479 +identifiers: + - type: doi + value: 10.5281/zenodo.22996479 + description: Zenodo archive of dataset v0.4.0 + - type: url + value: "https://github.com/adab-tech/mapping/releases/tag/v0.4.0" + description: GitHub release v0.4.0 date-released: "2026-09-27" authors: - family-names: Abubakar diff --git a/README.md b/README.md index 514b352..1a42b4e 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,7 @@ [![License: MIT](https://img.shields.io/badge/code-MIT-blue.svg)](LICENSE) [![Data: CC BY 4.0](https://img.shields.io/badge/data-CC%20BY%204.0-lightgrey.svg)](LICENSE) +[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.22996479.svg)](https://doi.org/10.5281/zenodo.22996479) [![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](CONTRIBUTING.md) **Live:** [adamu.tech/mapping](https://adamu.tech/mapping/) · @@ -110,12 +111,12 @@ by their holding institutions. ## How to cite > Abubakar, Adamu. *Mapping Voices: An Open Atlas of Oral-History and -> Voice-Testimony Collections*. Dataset, version 0.4.0, 2026-09-27. CC BY 4.0. -> https://adab-tech.github.io/mapping/ +> Voice-Testimony Collections* (v0.4.0) [Data set]. Zenodo, 2026. +> https://doi.org/10.5281/zenodo.22996479 Every dataset version is published as a GitHub release (created automatically when the version changes; see `.github/workflows/release.yml`) -and archived with a DOI on Zenodo once the integration is enabled. +and archived on Zenodo with its own DOI. To cite one collection, cite its holding institution and give the Mapping Voices identifier (e.g. `MV-000023`) as the finding aid. Machine-readable diff --git a/about.html b/about.html index 4cc4905..a5a7846 100644 --- a/about.html +++ b/about.html @@ -213,8 +213,8 @@

08 Future directions

09 Cite

Abubakar, Adamu. Mapping Voices: An Open Atlas of Oral-History and - Voice-Testimony Collections. Dataset, version 0.4.0, - 2026-09-27. CC BY 4.0. https://adab-tech.github.io/mapping/ + Voice-Testimony Collections (v0.4.0) [Data set]. Zenodo, 2026. + https://doi.org/10.5281/zenodo.22996479. CC BY 4.0.

To cite a single collection, cite the holding institution first, and give the diff --git a/data/datapackage.json b/data/datapackage.json index e2c7865..f177da2 100644 --- a/data/datapackage.json +++ b/data/datapackage.json @@ -1,5 +1,6 @@ { "profile": "data-package", + "id": "https://doi.org/10.5281/zenodo.22996479", "name": "mapping-voices", "title": "Mapping Voices: An Open Atlas of Oral-History and Voice-Testimony Collections", "version": "0.4.0", diff --git a/data/dataset-meta.json b/data/dataset-meta.json index 085a249..14162c7 100644 --- a/data/dataset-meta.json +++ b/data/dataset-meta.json @@ -3,6 +3,12 @@ "title": "Mapping Voices: An Open Atlas of Oral-History and Voice-Testimony Collections", "version": "0.4.0", "released": "2026-09-27", + "doi": { + "version": "0.4.0", + "doi": "10.5281/zenodo.22996479", + "url": "https://doi.org/10.5281/zenodo.22996479", + "note": "Zenodo DOI of the most recent archived version. Each release gets its own DOI; see the Zenodo record's version list." + }, "description": "A curated, openly licensed metadata dataset of real, publicly documented oral-history and voice-testimony collections worldwide, with normalized geographic, linguistic, thematic, and temporal metadata and a link to each holding institution's own page. The dataset describes and links to collections; it does not contain or redistribute their content.", "homepage": "https://adamu.tech/mapping/", "repository": "https://github.com/adab-tech/mapping", diff --git a/index.html b/index.html index bc6f0dd..aee7edf 100644 --- a/index.html +++ b/index.html @@ -27,6 +27,7 @@ "description": "An open, curated dataset of real, publicly documented oral-history and voice-testimony collections worldwide, with normalized geographic, linguistic, thematic, and temporal metadata and a link to each holding institution's own page.", "url": "https://adab-tech.github.io/mapping/", "version": "0.4.0", + "identifier": "https://doi.org/10.5281/zenodo.22996479", "dateModified": "2026-09-27", "license": "https://creativecommons.org/licenses/by/4.0/", "creator": { diff --git a/scripts/build-data.mjs b/scripts/build-data.mjs index 24ec7aa..c612906 100644 --- a/scripts/build-data.mjs +++ b/scripts/build-data.mjs @@ -195,6 +195,7 @@ const stats = { const datapackage = { profile: "data-package", + ...(meta.doi ? { id: meta.doi.url } : {}), name: meta.name, title: meta.title, version: meta.version,