Skip to content

Conversation

@egrace479
Copy link
Member

Moves CITATION.cff into the "Standard Files" section.
- We expect citation instructions to be made available, this is automatically read when integrating with Zenodo (an added note in the section), and this also would hopefully help in inspiring an earlier authorship conversation for a project.
- I fit this last note on authorship in with note on project life cycle—is this link better as a footnote?
Adds note on using the version agnostic Zenodo DOI for citation in repository.
- Included as both a comment in the template CITATION.cff and in the note admonition preceding it. The motivation is provided in the latter.

I plan to add a .zenodo.json file to the "Recommended Files" section, so it will still be plural. I just didn't want to overload this PR. That update will also include some editing/links between this and the Zenodo part of the DOI Generation page.

@egrace479 egrace479 requested a review from hlapp October 22, 2025 19:23
@egrace479 egrace479 added documentation Improvements or additions to documentation structure Refactoring or architecture, general code organization labels Oct 22, 2025
Copy link
Member

@hlapp hlapp left a comment

Choose a reason for hiding this comment

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

Looks all good! 👍

@egrace479 egrace479 merged commit 79e2616 into main Oct 23, 2025
@egrace479 egrace479 deleted the citation-reorg branch October 23, 2025 17:07
egrace479 added a commit to Imageomics/Imageomics-guide that referenced this pull request Oct 29, 2025
Pull from Collab Guide [PR 24](Imageomics/Collaborative-distributed-science-guide#24)

* Add note on which DOI to use from Zenodo and why, link for reference

* Move citation to standard files section

Citation files are important for provenance of research software, we expect them

* Add clarification about updating throughout project lifespan, link to project life cycle
egrace479 added a commit to Imageomics/Imageomics-guide that referenced this pull request Oct 29, 2025
Pull from Collab Guide [PR 24](Imageomics/Collaborative-distributed-science-guide#24)

* Add note on which DOI to use from Zenodo and why, link for reference

* Move citation to standard files section

Citation files are important for provenance of research software, we expect them

* Add clarification about updating throughout project lifespan, link to project life cycle
egrace479 added a commit to ABC-Center/ABC-guide that referenced this pull request Oct 29, 2025
Pull from Collab Guide [PR 24](Imageomics/Collaborative-distributed-science-guide#24)

* Add note on which DOI to use from Zenodo and why, link for reference

* Move citation to standard files section

Citation files are important for provenance of research software, we expect them

* Add clarification about updating throughout project lifespan, link to project life cycle
egrace479 added a commit to ABC-Center/ABC-guide that referenced this pull request Oct 31, 2025
Pull from Collab Guide [PR 24](Imageomics/Collaborative-distributed-science-guide#24)

* Add note on which DOI to use from Zenodo and why, link for reference

* Move citation to standard files section

Citation files are important for provenance of research software, we expect them

* Add clarification about updating throughout project lifespan, link to project life cycle
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation structure Refactoring or architecture, general code organization

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants