Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Replace CITATION.bib with CITATION.cff for better GitHub integration #272

Merged
merged 6 commits into from
Mar 31, 2025

Conversation

EwoutH
Copy link
Member

@EwoutH EwoutH commented Dec 29, 2024

Replaced the existing CITATION.bib file with a CITATION.cff file to leverage GitHub's native citation support. The CITATION.cff file provides both human- and machine-readable citation metadata, allowing users to easily cite the repository in formats like APA and BibTeX directly from GitHub's "Cite this repository" feature.

The new CITATION.cff includes:

  • Author details
  • Title, DOI, and URL
  • Book title and conference details
  • Keywords and abstract

This change aligns with modern citation practices for software and academic works on GitHub. See:

Replaced the existing `CITATION.bib` file with a `CITATION.cff` file to leverage GitHub's native citation support. The `CITATION.cff` file provides both human- and machine-readable citation metadata, allowing users to easily cite the repository in formats like APA and BibTeX directly from GitHub's "Cite this repository" feature.

The new `CITATION.cff` includes:
- Author details  
- Title, DOI, and URL  
- Book title and conference details  
- Keywords and abstract  

This change aligns with modern citation practices for software and academic works on GitHub.
@EwoutH EwoutH requested a review from wang-boyu December 29, 2024 19:53
@EwoutH
Copy link
Member Author

EwoutH commented Dec 29, 2024

Hmmm I get this weird warning I can't seem to get rid of, while the CFF seems to be formatted correctly.

image

The issue might be that it isn't present on the main branch, but not sure.

@wang-boyu wang-boyu added the docs Release notes label label Jan 1, 2025
@wang-boyu
Copy link
Member

Thanks! There's a link to the removed .bib file in README. Shall we change it to point to the "Cite this repository" feature instead?

@wang-boyu
Copy link
Member

Hi @EwoutH, I'm trying to make some changes to the citation files. Is it possible for you to enable maintainer edits for this PR?

@EwoutH
Copy link
Member Author

EwoutH commented Mar 30, 2025

This PR is on a mesa-geo branch, so you should already be able to: https://github.com/projectmesa/mesa-geo/tree/citation_cff

Totally forgot it by the way, so thanks for picking it up!

@wang-boyu
Copy link
Member

Got it. Thanks!!

@wang-boyu wang-boyu force-pushed the citation_cff branch 3 times, most recently from 6d32a86 to bbfcb05 Compare March 30, 2025 20:36
@wang-boyu
Copy link
Member

Should be ready now. @EwoutH would you like to take a look at this when you have time before merging?

Copy link
Member

@tpike3 tpike3 left a comment

Choose a reason for hiding this comment

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

Just piling on! :) LGTM

@EwoutH
Copy link
Member Author

EwoutH commented Mar 31, 2025

Awesome, thanks!

@EwoutH EwoutH merged commit 8d65e61 into main Mar 31, 2025
11 checks passed
@wang-boyu
Copy link
Member

Thanks @tpike3 and @EwoutH !

@wang-boyu wang-boyu deleted the citation_cff branch April 1, 2025 00:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Release notes label
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants