Skip to content

docs: add CITATION.cff and DOI badge to make citing burst2safe easier - #255

Open
ltianyi992 wants to merge 1 commit into
ASFHyP3:developfrom
ltianyi992:docs/add-citation-cff-and-doi-badge
Open

docs: add CITATION.cff and DOI badge to make citing burst2safe easier#255
ltianyi992 wants to merge 1 commit into
ASFHyP3:developfrom
ltianyi992:docs/add-citation-cff-and-doi-badge

Conversation

@ltianyi992

Copy link
Copy Markdown

Summary

Closes #254

Users wanting to cite burst2safe in academic work have no discoverable citation pointer in the repository. The Zenodo DOI and example citation were provided in discussion #152 but never committed to the repo.

Changes

CITATION.cff (new file)

A Citation File Format 1.2.0 file with:

  • Full author list (from the Zenodo record in Citation ? #152)
  • Zenodo concept DOI 10.5281/zenodo.14538103
  • License, version, and keywords

GitHub automatically detects CITATION.cff and shows a "Cite this repository" button on the repo homepage that generates APA and BibTeX output.

README.md

  1. DOI badge added below the title — links directly to the Zenodo concept record (always resolves to the latest version):

    DOI

  2. Citation section added before the License section with:

    • Recommended APA citation for v2.0.2
    • Link to the Zenodo record for BibTeX and other formats
    • Note about the GitHub "Cite this repository" button

Users wanting to cite burst2safe in academic work currently have no
discoverable pointer in the repository. The Zenodo DOI and citation info
were discussed in ASFHyP3#152 but never committed.

Changes:
  CITATION.cff — CFF 1.2.0 file with full author list, Zenodo concept DOI
                 (10.5281/zenodo.14538103), license, and keywords. GitHub
                 surfaces a "Cite this repository" button that generates APA
                 and BibTeX output from this file automatically.
  README.md    — Adds a Zenodo DOI badge below the title and a new
                 "Citation" section with the recommended APA citation for
                 v2.0.2, a link to the Zenodo record for other formats, and
                 a note about the CITATION.cff button.

Closes ASFHyP3#254
@ltianyi992
ltianyi992 requested a review from a team as a code owner June 5, 2026 05:56
@jhkennedy jhkennedy moved this to Needs Review in SciDev Team Board Jun 25, 2026
@jhkennedy

Copy link
Copy Markdown
Contributor

Thanks Claude, we'll need to add ORCIDs for the people who have them as well as ensure all the netries have propper names. There's a few citation.cff files in this org that that information could be gathered from. We may also need to include a gitmapping like in nisar-docs to combine differently styled commmits.

See latest prior work in these two PRs:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Needs Review

Development

Successfully merging this pull request may close these issues.

Add Citation.cff to repo and DOI badge to README

2 participants