add CITATION.cff

[Aariq]

This draft PR adds a CITATION.cff file. This file gets used by GitHub to populate a little "Cite This Repository" button and is used by Zenodo to populate archive metadata. Please help by filling out your info in it including ORCID if you have one and affiliation. See Kristina's entry for an example of formatting. You do not need to include your email, as I think it makes sense to only include one.

Questions/comments:

• The only allowed citation types are "software" or "data"
• BUT, we can use a preferred-citation: that can be of any type, e.g. "book". That will override the software citation for GitHub's "cite this" button, but I don't think Zenodo uses that information. Maybe keeping the type as software is fine.
• I'm not sure if it is most appropriate to use your current affiliation or you affiliation at the time of contribution. Would love opinions on this
• Authors are in order of: Kristina, authors from OSF citation, new members in order of joining the group. Happy to take suggestions on a different order. I figure leader first, every one else in order of contribution is probably fine?
• We can include a version: in CITATION.cff but for this book it seemed more appropriate to just update the date-released every time we archive a snapshot of the repo.

Still TODO:

• [ ] Add citation info to _quarto.yml

After this PR is merged, I'll link to Zenodo, make a release, and then add the new DOI to CITATION.cff and _quarto.yml

[dlebauer]

Thanks for doing this!

• Can't the type be 'manual'? https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-citation-files#citing-something-other-than-software
• Regarding authorship:
  • I agree it makes sense for Kristina to be first author as she has taken leadership of the group and is responsible for how it works.
  • I don't think it makes sense to keep the original order (me then alphabetical) and then switch to the order of joining the group; I like the idea of order of joining the group. I'd propose [Kristina, order of joining group, David].
  • plz add a comment to the CFF with the protocol + link to this PR

[Aariq]

Can't the type be 'manual'?

Not according to cffr::cff_validate() or the cffinit tool

I don't think it makes sense to keep the original order (me then alphabetical) and then switch to the order of joining the group; I like the idea of order of joining the group. I'd propose [Kristina, order of joining group, David].

Sounds great to me, but I don't know the order. Could you suggest a change in the PR?

plz add a comment to the CFF with the protocol + link to this PR

Good idea. I'll add a note to the message: field as well as a comment linking to this discussion.

[dlebauer]

proposed changes in #51

It appears cffr and ccfinit are correctly implemented based on the specification https://github.com/citation-file-format/citation-file-format/blob/main/schema-guide.md#type but inconsistent with the documentation; I'd suggest going w/ data and seeing what comes of https://github.com/orgs/community/discussions/110648

[Aariq]

type: manual is only valid for preferred-citation, not the main citation type where only software and data are allowed. don't think that preferred-citation is used for the primary citation metadata by Zenodo the way it is by GitHub. Not sure though.

[Aariq]

I'll check in with folks at standup and try to get this merged today or tomorrow and I'll open a follow-up issue for adding metadata to _quarto.yml