Skip to content

📝 Add CITATION.cff - #35

Merged
vanandrew merged 1 commit into
mainfrom
docs/citation-cff
Aug 6, 2026
Merged

📝 Add CITATION.cff#35
vanandrew merged 1 commit into
mainfrom
docs/citation-cff

Conversation

@vanandrew

Copy link
Copy Markdown
Owner

Adds a CITATION.cff at the repo root so GitHub renders a "Cite this repository"
button and tools like Zenodo/cffconvert can emit BibTeX/APA/EndNote automatically.
Previously the citation only existed as prose in README.md and LICENSE.

Changes

  • New CITATION.cff (CFF 1.2.0), type: software.
  • authors — the software authors, mirroring the README "Authors" section
    (Andrew N. Van, Vahdeta Suljic). Andrew is listed first to match LICENSE's
    "Authored by" line and [project].authors in pyproject.toml.
  • preferred-citation — the MEDIC paper as type: article, with the complete
    33-author list (the README/LICENSE prose truncates at "et al."), plus journal,
    year, volume, article number, ISSN, and DOI.
  • Author names and ORCIDs were pulled from Crossref via DOI content negotiation
    on 10.1162/IMAG.a.1262 rather than typed by hand.
  • license-url points at LICENSE instead of an SPDX license identifier —
    warpkit's non-commercial WashU license has no SPDX ID, and CFF's license
    field only accepts SPDX enums.

Verification

  • uvx cffconvert --validateCitation metadata are valid according to schema version 1.2.0.
  • uvx cffconvert -f apalike renders cleanly.
  • pre-commit run --files CITATION.cff passes (codespell clean).

Not CI-relevant: no build, packaging, or wheel-matrix impact.

Copilot AI lite review requested due to automatic review settings August 6, 2026 18:43

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a root-level CITATION.cff so GitHub and citation tooling (e.g., cffconvert/Zenodo) can automatically render and export canonical citation metadata for warpkit, instead of relying on prose-only guidance in the README/LICENSE.

Changes:

  • Introduces CITATION.cff in CFF 1.2.0 format describing the software (type: software) and its authors.
  • Adds a preferred-citation entry for the MEDIC paper with expanded bibliographic metadata and the full author list.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@vanandrew
vanandrew merged commit 4ae7699 into main Aug 6, 2026
1 check passed
@vanandrew
vanandrew deleted the docs/citation-cff branch August 6, 2026 18:48
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.

2 participants