Skip to content

Commit 4fa0e32

Browse files
committed
Record the Zenodo DOI and unstick the PyPI badges
Zenodo had never archived v0.1.0. The webhook was installed 39 minutes after the release was published, and its delivery log confirmed the diagnosis: a single ping, no release event. Re-publishing the release through a draft toggle replayed the event without deleting anything, and Zenodo minted: version DOI 10.5281/zenodo.21879360 concept DOI 10.5281/zenodo.21879359 Both are now recorded in CITATION.cff, codemeta.json and the changelog, with the badge and a citation block in the README and the docs home page. The distinction is spelled out rather than assumed: cite the version DOI for reproducibility, the concept DOI for the project. The PyPI and Python badges rendered broken because GitHub's camo proxy had cached the not-found images produced while the package did not yet exist on PyPI. The shields endpoints themselves resolved correctly all along. Camo keys its cache on the source URL, so the badge URLs now carry logo and label parameters, which busts the stale entries and improves them at the same time.
1 parent d5f09de commit 4fa0e32

6 files changed

Lines changed: 46 additions & 7 deletions

File tree

.zenodo.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,11 @@
4040
"identifier": "https://github.com/DiogoRibeiro7/setqca-python",
4141
"relation": "isSupplementTo",
4242
"scheme": "url"
43+
},
44+
{
45+
"identifier": "https://pypi.org/project/setqca/",
46+
"relation": "isIdenticalTo",
47+
"scheme": "url"
4348
}
4449
]
4550
}

CHANGELOG.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1010
## [0.1.0] — 2026-08-10
1111

1212
First public release.
13+
Archived on Zenodo: [10.5281/zenodo.21879360](https://doi.org/10.5281/zenodo.21879360)
14+
(concept DOI [10.5281/zenodo.21879359](https://doi.org/10.5281/zenodo.21879359)).
1315

1416
### Added
1517

CITATION.cff

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,14 @@ title: "setqca: Native Python Crisp-Set and Fuzzy-Set Qualitative Comparative An
44
version: "0.1.0"
55
date-released: 2026-08-10
66
type: software
7+
doi: 10.5281/zenodo.21879360
8+
identifiers:
9+
- type: doi
10+
value: 10.5281/zenodo.21879359
11+
description: Concept DOI resolving to the latest archived version
12+
- type: doi
13+
value: 10.5281/zenodo.21879360
14+
description: Version DOI for release 0.1.0
715
authors:
816
- family-names: Ribeiro
917
given-names: Diogo

README.md

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,9 @@
22

33
[![CI](https://github.com/DiogoRibeiro7/setqca-python/actions/workflows/ci.yml/badge.svg)](https://github.com/DiogoRibeiro7/setqca-python/actions/workflows/ci.yml)
44
[![Documentation](https://github.com/DiogoRibeiro7/setqca-python/actions/workflows/docs.yml/badge.svg)](https://diogoribeiro7.github.io/setqca-python/)
5-
[![PyPI](https://img.shields.io/pypi/v/setqca.svg)](https://pypi.org/project/setqca/)
6-
[![Python](https://img.shields.io/pypi/pyversions/setqca.svg)](https://pypi.org/project/setqca/)
5+
[![PyPI](https://img.shields.io/pypi/v/setqca?logo=pypi&logoColor=white&label=PyPI)](https://pypi.org/project/setqca/)
6+
[![Python](https://img.shields.io/pypi/pyversions/setqca?logo=python&logoColor=white&label=Python)](https://pypi.org/project/setqca/)
7+
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.21879359.svg)](https://doi.org/10.5281/zenodo.21879359)
78
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
89
[![Checked with mypy](https://img.shields.io/badge/mypy-strict-blue.svg)](https://mypy-lang.org/)
910
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
@@ -217,9 +218,22 @@ mathematical core.
217218

218219
## Citing
219220

220-
If you use `setqca` in published research, please cite the archived release.
221+
If you use `setqca` in published research, please cite the archived release:
222+
223+
> Ribeiro, D. (2026). *setqca: Native Python Crisp-Set and Fuzzy-Set Qualitative
224+
> Comparative Analysis* (version 0.1.0) [Computer software]. Zenodo.
225+
> <https://doi.org/10.5281/zenodo.21879360>
226+
227+
Two DOIs are available. Cite the **version DOI**
228+
([10.5281/zenodo.21879360](https://doi.org/10.5281/zenodo.21879360)) when the
229+
exact version matters for reproducibility, which for a set-theoretic method it
230+
usually does. Cite the **concept DOI**
231+
([10.5281/zenodo.21879359](https://doi.org/10.5281/zenodo.21879359)) to refer to
232+
the project as a whole; it always resolves to the latest archived release.
233+
221234
Machine-readable metadata is provided in [`CITATION.cff`](CITATION.cff),
222-
[`codemeta.json`](codemeta.json) and [`.zenodo.json`](.zenodo.json).
235+
[`codemeta.json`](codemeta.json) and [`.zenodo.json`](.zenodo.json). GitHub
236+
renders "Cite this repository" from the first of these.
223237

224238
## License
225239

codemeta.json

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,9 @@
2626
"Python"
2727
],
2828
"datePublished": "2026-08-10",
29-
"identifier": "https://github.com/DiogoRibeiro7/setqca-python",
29+
"identifier": "https://doi.org/10.5281/zenodo.21879360",
30+
"sameAs": "https://doi.org/10.5281/zenodo.21879359",
31+
"downloadUrl": "https://pypi.org/project/setqca/",
3032
"author": [
3133
{
3234
"@type": "Person",

docs/index.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,8 +52,16 @@ Continue with [Getting started](getting-started.md), or jump to the
5252

5353
## Citing
5454

55-
If you use `setqca` in published research, please cite the archived release.
56-
Citation metadata is provided in [`CITATION.cff`](https://github.com/DiogoRibeiro7/setqca-python/blob/main/CITATION.cff).
55+
If you use `setqca` in published research, please cite the archived release:
56+
57+
> Ribeiro, D. (2026). *setqca: Native Python Crisp-Set and Fuzzy-Set Qualitative
58+
> Comparative Analysis* (version 0.1.0) [Computer software]. Zenodo.
59+
> <https://doi.org/10.5281/zenodo.21879360>
60+
61+
Cite the version DOI above when the exact version matters for reproducibility;
62+
cite the concept DOI [10.5281/zenodo.21879359](https://doi.org/10.5281/zenodo.21879359)
63+
to refer to the project as a whole. Citation metadata is provided in
64+
[`CITATION.cff`](https://github.com/DiogoRibeiro7/setqca-python/blob/main/CITATION.cff).
5765

5866
## License
5967

0 commit comments

Comments
 (0)