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

Rewrite 12-citation #1063

Open
martinosorb opened this issue Jan 20, 2025 · 0 comments
Open

Rewrite 12-citation #1063

martinosorb opened this issue Jan 20, 2025 · 0 comments

Comments

@martinosorb
Copy link
Contributor

How could the content be improved?

The episode on citations has not been properly reviewed since 2017 and, in my opinion, entirely lacks depth and clarity. I suggest we work on a new version which imho should:

  • Offer clearer motivation on why these citation formats exist, and why one "may want to include" one of them, for example summarizing a tiny bit of the linked Software Sustainability Institute blog post, which seems to be a rich resource
  • Better integrate the section on bibtex with the last sentence, which is unclear and feels dropped from nowhere, and with the new section on CFF which is coming (feature: Adds details on using CITATION.cff #1021)
  • Do not cite the paper in the code format which draws unnecessary attention
  • However, it should not become too much longer, since there's always very little time for these smaller, final episodes.

Which part of the content does your suggestion apply to?

https://swcarpentry.github.io/git-novice/12-citation.html

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

No branches or pull requests

1 participant