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

Add CITATION.cff advice #148

Merged
merged 2 commits into from
Aug 28, 2023
Merged

Add CITATION.cff advice #148

merged 2 commits into from
Aug 28, 2023

Conversation

graeme-a-stewart
Copy link
Member

Add a recommendation to use the CITATION.cff format for advertising how to cite software - it's the standard way to do it these days!

CITATION.cff is now the standard for software projects to give their
citation information in human and machine readable formats. Added to
the document.

General Markdown lint was applied as well, using the markdownlint plugin
for VS Code.
We should really take the title from the YAML frontmatter, but that
doesn't seem to work with our current processing options.
Copy link
Member

@hegner hegner left a comment

Choose a reason for hiding this comment

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

Thanks. A great addition.

@hegner hegner merged commit 5526a53 into master Aug 28, 2023
@graeme-a-stewart graeme-a-stewart deleted the software-docs-update branch August 30, 2023 12:24
@eduardo-rodrigues
Copy link
Member

Hello @graeme-a-stewart, @hegner, I'm coming late to the party but since you mentioned earlier today at the coords meeting that you would welcome feedback - recently the developer guide in the Scikit-HEP website was moved "up" to Scientific Python; it is now far more visible and useful to a broader community. You can see the end result at https://learn.scientific-python.org/development/. Maybe that's something useful to add to here even if many things are specific for Python?
You will know best where, if, to include such information.

BTW, one brilliant tools is the "repository review" https://learn.scientific-python.org/development/guides/repo-review/. Just paste a repo URL and see it running even on the browser :-).

HTH.

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.

None yet

3 participants