python-tooling icon indicating copy to clipboard operation
python-tooling copied to clipboard

Task: Make this repository citeable

Open matt-graham opened this issue 11 months ago • 7 comments

What needs to be done?

We should add a CITATION.cff file to make it clear how to cite this repository itself, particularly as we're starting to think about advertising more widely. Relatedly we may also want to set up the Zenodo integration for the repository if we haven't already done so we get DOIs when we make a release.

### Tasks
- [x] Enable Zenodo integration
- [ ] Add `CITATION.cff` file
- [ ] Automate updating author list in `CITATION.cff`

matt-graham avatar Mar 25 '24 10:03 matt-graham

I had wondered about this recently 🤔 prompted by the Code for Thought podcast recently

paddyroddy avatar Mar 25 '24 11:03 paddyroddy

Now that GitHub allows linking ORCIDs to profiles it feels like there should be a way to automate keeping the author list on a CITATION.cff up to date (assuming this is based on contributor list, potentially with some filtering) 🤔

matt-graham avatar Mar 25 '24 11:03 matt-graham

I'm still a bit confused what the ORCiD bit is doing in CITATION.cff. Like it doesn't appear in the output Roddy, P. J. (2023). SLEPLET: Slepian Scale-Discretised Wavelets in Python. Journal of Open Source Software, 8(84), 5221. https://doi.org/10.21105/joss.05221 image

paddyroddy avatar Mar 25 '24 11:03 paddyroddy

The Zenodo integration automatically picks up ORCIDs from the CITATION.cff file I think for example (e.g. https://zenodo.org/records/10144016). I think the purpose of the file is more general than the GitHub usage.

matt-graham avatar Mar 25 '24 11:03 matt-graham

Maybe you're right. I know mine has picked up the ORCiD here doi.org/10.5281/zenodo.7268074, but that could have easily been from my Zenodo account (like I wouldn't need CITATION.cff to achieve the same). But maybe for co-authors it is necessary...

paddyroddy avatar Mar 25 '24 11:03 paddyroddy

Related zenodo/zenodo#596

paddyroddy avatar Mar 25 '24 11:03 paddyroddy

I guess we want a DOI for the pages too?

samcunliffe avatar Mar 25 '24 13:03 samcunliffe

I've created a separate issue for the remain task (#411) but I think the main points here have been resolved by #340 so closing.

matt-graham avatar Jun 07 '24 12:06 matt-graham