Skip to content

Add CITATION.cff and a Citation section - #46

Merged
tae898 merged 1 commit into
mainfrom
add-citation-cff
Oct 25, 2026
Merged

tae898 merged 1 commit into
mainfrom
add-citation-cff

Conversation

@tae898

@tae898 tae898 commented Oct 25, 2026

Copy link
Copy Markdown
Collaborator

What

Adds CITATION.cff (CFF 1.2.0) so GitHub shows "Cite this repository", and a two-line Citation section in the README. This is the "CITATION.cff only" decision of 2026-10-25: no Zenodo for now.

  • title: ArcadeDB Python, type: software, license: Apache-2.0, repository-code: https://github.com/ArcadeData/arcadedb-python, url: https://arcadedb.com.
  • Authors: the organisation entity "Arcade Data Ltd" (the name REUSE.toml uses; alias ArcadeData, the GitHub org) and Taewoon Kim. Taewoon Kim is also the contact (maintainer).
  • No version and no date-released, on purpose: this repository has made no release yet (the first is 26.11.1), and the wheel version is derived from the engine jar at build time (pyproject.toml holds the placeholder 0.0.0), so a number written here would go stale. A comment in the file says to add both when a release is cut. Nothing in scripts/check_version.py or the release workflow reads this file.
  • The file carries the same SPDX header as the other files.

Zenodo

Left to ArcadeData. Enabling it needs an ArcadeData org owner to approve the Zenodo OAuth app, and it would create a new concept DOI. There is no DOI in the file, and the README says so. If ArcadeData enables Zenodo later, the DOI goes into identifiers here.

Not added: a preferred-citation for the SciPy 2026 paper and the earlier software record (concept DOI of humemai/arcadedb-embedded-python). Both are possible follow-ups once the paper is citable.

Checks run locally

  • uvx cffconvert --validate -i CITATION.cff: "Citation metadata are valid according to schema version 1.2.0." (An earlier draft with a copyright: key, copied from ArcadeData/arcadedb's CITATION.cff, failed this check, so the key is not here. That file in ArcadeData/arcadedb has the same problem.)
  • uvx cffconvert -f bibtex and -f apalike: both render.
  • pre-commit run --files CITATION.cff README.md: passes.
  • python3 scripts/check_no_embedded_name.py: passes.

🤖 Generated with Claude Code

Authors are Arcade Data Ltd (alias ArcadeData, as REUSE.toml names it) and Taewoon Kim, who is also the contact. No version or date-released: this repository has made no release yet, and the wheel version is derived from the engine jar at build time. No DOI: Zenodo is left to ArcadeData.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@tae898
tae898 merged commit 83682dd into main Oct 25, 2026
46 checks passed
@tae898
tae898 deleted the add-citation-cff branch October 25, 2026 07:52
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