Skip to content

docs: add .zenodo.json release metadata - #9

Merged
sparkainlp-x merged 1 commit into
mainfrom
docs/zenodo-json
Sep 27, 2026
Merged

sparkainlp-x merged 1 commit into
mainfrom
docs/zenodo-json

Conversation

@sparkainlp-x

Copy link
Copy Markdown
Owner

Adds a .zenodo.json so future GitHub-release archives on Zenodo get curated metadata instead of auto-extracted defaults.

What's in it

  • upload_type: software, title identical to the current Zenodo record and CITATION.cff
  • HTML description drawn only from this README (evidence tags preserved, explicit scope/limits paragraph; only Zenodo-allowed HTML tags)
  • creators: Brisson, Jean-François (Spark AI NLP); license: MIT (matches LICENSE and CITATION.cff); access_right: open; language: eng
  • curated keywords and related_identifiers (see file)
  • No version (Zenodo takes it from the tag) and no communities (the community does not exist yet; referencing it would break archiving)

Validation

  • Parses as JSON; checked against Zenodo's legacy deposit JSON Schema (zenodo/zenodo master legacyrecord.json). That schema file predates the documented language field, so language was excluded for the schema check only; it is listed in the deposit-metadata docs (developers.zenodo.org#representation) and the help-page .zenodo.json example.
  • Title / author / license cross-checked against CITATION.cff and the published Zenodo record. Note: when .zenodo.json exists, Zenodo ignores CITATION.cff for archiving, so the two must stay consistent.

Notes

  • ORCID is intentionally omitted for now; it will be added later (here and in CITATION.cff) once provided.
  • No release is cut by this PR; the metadata applies from the next tagged release. Existing records can be edited by hand on Zenodo.
  • Docs/metadata-only change; no code changes.

@sparkainlp-x
sparkainlp-x merged commit 330b224 into main Sep 27, 2026
2 checks passed
@sparkainlp-x
sparkainlp-x deleted the docs/zenodo-json branch September 27, 2026 02:50
sparkainlp-x added a commit that referenced this pull request Sep 27, 2026
Adds a `.zenodo.json` so future GitHub-release archives on Zenodo get
curated metadata instead of auto-extracted defaults.

**What's in it**
- `upload_type: software`, title identical to the current Zenodo record
and `CITATION.cff`
- HTML description drawn only from this README (evidence tags preserved,
explicit scope/limits paragraph; only Zenodo-allowed HTML tags)
- creators: `Brisson, Jean-François` (Spark AI NLP); `license: MIT`
(matches `LICENSE` and `CITATION.cff`); `access_right: open`; `language:
eng`
- curated keywords and `related_identifiers` (see file)
- **No** `version` (Zenodo takes it from the tag) and **no**
`communities` (the community does not exist yet; referencing it would
break archiving)

**Validation**
- Parses as JSON; checked against Zenodo's legacy deposit JSON Schema
(`zenodo/zenodo` master `legacyrecord.json`). That schema file predates
the documented `language` field, so `language` was excluded for the
schema check only; it is listed in the deposit-metadata docs
(developers.zenodo.org#representation) and the help-page `.zenodo.json`
example.
- Title / author / license cross-checked against `CITATION.cff` and the
published Zenodo record. Note: when `.zenodo.json` exists, Zenodo
ignores `CITATION.cff` for archiving, so the two must stay consistent.

**Notes**
- ORCID is intentionally omitted for now; it will be added later (here
and in `CITATION.cff`) once provided.
- No release is cut by this PR; the metadata applies from the next
tagged release. Existing records can be edited by hand on Zenodo.
- Docs/metadata-only change; no code changes.
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