Skip to content

docs: add repository citation guidance and metadata#146

Merged
jake-arkinstall merged 3 commits intomainfrom
ks-add-citation-file
Apr 6, 2026
Merged

docs: add repository citation guidance and metadata#146
jake-arkinstall merged 3 commits intomainfrom
ks-add-citation-file

Conversation

@qartik
Copy link
Copy Markdown
Member

@qartik qartik commented Mar 30, 2026

Summary

  • add a top-level CITATION.cff for GitHub citation support
  • add a Citation section to README.md with a BibTeX example for repository-level citation
  • align the project description wording in pyproject.toml with the citation metadata

Resolves #145

CITATION.cff Outdated
message: "If you use Selene in your work, please cite it using the metadata from this file."
title: "Selene"
type: software
abstract: "Quantinuum's open source emulator for hybrid quantum computation."
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I believe we are deprecating the use of the word 'hybrid' for this purpose as it is in conflict with the use of the same phrase for HPC-Quantum.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

It was copied over from pyproject.toml, I will update that as well. Though you may need to edit it in the About section of the repo.

Copy link
Copy Markdown
Member Author

@qartik qartik Mar 30, 2026

Choose a reason for hiding this comment

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

Updated in both places: I changed the CFF abstract and the pyproject description to use "quantum computation" rather than "hybrid quantum computation" so the metadata stays aligned and does not regress.

Comment on lines +48 to +55
@software{selene,
title = {Selene},
author = {Arkinstall, Jake and {TKET development team}},
year = {2025},
organization = {Quantinuum},
url = {https://github.com/Quantinuum/selene},
license = {Apache-2.0},
}
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

the backwards-compatible version would be:

@misc{selene,
  title = {Selene},
  author = {Arkinstall, Jake and {TKET development team}},
  year = {2025},
  howpublished = {\url{https://github.com/Quantinuum/selene}},
}

but I prefer the modern version.

@qartik qartik requested a review from jake-arkinstall March 30, 2026 14:25
@qartik qartik changed the title chore: add repository citation metadata docs: add repository citation guidance and metadata Mar 30, 2026
@ss2165 ss2165 removed their request for review March 31, 2026 09:40
@qartik
Copy link
Copy Markdown
Member Author

qartik commented Apr 6, 2026

@jake-arkinstall I believe this is ready to merge, the CI failures are unrelated to this PR.

@jake-arkinstall jake-arkinstall merged commit 880a58b into main Apr 6, 2026
8 of 23 checks passed
@jake-arkinstall jake-arkinstall deleted the ks-add-citation-file branch April 6, 2026 18:37
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.

Add citation/bibtex file

2 participants