Skip to content

docs: add a citation file - #222

Open
MAfarrag wants to merge 1 commit into
mainfrom
docs/add-citation-file
Open

MAfarrag wants to merge 1 commit into
mainfrom
docs/add-citation-file

Conversation

@MAfarrag

Copy link
Copy Markdown
Member

What this adds

A CITATION.cff so the package can be cited properly.

GitHub reads this file and shows a Cite this repository button on the repository page, offering APA and BibTeX.
Without it there is no machine-readable citation, and anyone referencing this package in a paper has to improvise
one.

Where the content came from

Nothing here is hand-written:

  • title, abstract, version and keywords — from pyproject.toml on main
  • license — the repository's SPDX identifier
  • date-released — the latest GitHub release
  • repository-code / url — the repository and its documentation site

Verification

Validated against the Citation File Format 1.2 schema with cffconvert.

Follow-up

This pairs with a Zenodo DOI: connecting the repository to Zenodo mints a DOI per release, which can then be added
to this file as doi: and cited directly. Not part of this change.

Without CITATION.cff there is no machine-readable way to cite this
package, and GitHub shows no "Cite this repository" button, so anyone
referencing it in a paper has to improvise.

The fields are taken from the package itself: title and version from
pyproject.toml, licence from the repository, release date from the
latest release, and keywords from those already declared.
@sonarqubecloud

Copy link
Copy Markdown

This branch has not been deployed

No deployments
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