git-novice icon indicating copy to clipboard operation
git-novice copied to clipboard

Rewrite 12-citation

Open martinosorb opened this issue 10 months ago • 0 comments

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 (#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

martinosorb avatar Jan 20 '25 19:01 martinosorb