Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions .claude/skills/release-dataset/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,5 +30,8 @@ description: Cut a new Mapping Voices dataset version — bump the version every
`v<version>` 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).
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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<version>`
whenever the dataset version changes on `main` (or on demand), with
Expand Down
8 changes: 8 additions & 0 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/) ·
Expand Down Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions about.html
Original file line number Diff line number Diff line change
Expand Up @@ -213,8 +213,8 @@ <h2 id="h-future"><span class="num">08</span> Future directions</h2>
<h2 id="h-cite"><span class="num">09</span> Cite</h2>
<p class="citation" id="citation-text">
Abubakar, Adamu. <em>Mapping Voices: An Open Atlas of Oral-History and
Voice-Testimony Collections</em>. Dataset, version <span data-stat="version">0.4.0</span>,
<span data-stat="released">2026-09-27</span>. CC BY 4.0. https://adab-tech.github.io/mapping/
Voice-Testimony Collections</em> (v0.4.0) [Data set]. Zenodo, 2026.
<a href="https://doi.org/10.5281/zenodo.22996479">https://doi.org/10.5281/zenodo.22996479</a>. CC BY 4.0.
</p>
<p>
To cite a single collection, cite the holding institution first, and give the
Expand Down
1 change: 1 addition & 0 deletions data/datapackage.json
Original file line number Diff line number Diff line change
@@ -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",
Expand Down
6 changes: 6 additions & 0 deletions data/dataset-meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
1 change: 1 addition & 0 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down
1 change: 1 addition & 0 deletions scripts/build-data.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down
Loading