Citation.cff and citation guidelines

[MakisH]

Similarly to the-teachingRSE-project/competencies#253, we need a CFF file here as well.

We should also include some citation guidelines in the home page.

[MakisH]

In our last meeting, we also discussed having regular releases (e.g., once per semester/year) and putting those on Zenodo for archival. The DOI of each version would be different, but there is also an umbrella DOI for all versions.

@CaptainSifff given that we have papers citing this, I think it would be a good time to make a first release and put a snapshot on Zenodo. I would then go ahead and create one, unless you think otherwise.

To give credit to people, we could put the names of people that contributed to each release (or in total) on Zenodo. This is what we do, for example, in the preCICE Distribution: https://darus.uni-stuttgart.de/dataset.xhtml?persistentId=doi:10.18419/darus-4167

[CaptainSifff]

Let's go for zenodo. A minor complication comes here, how to deal with minor contributions like in #37 . Do we want to define, what constitutes a minimum contribution for authorship? I currently tend towards a very open model to increase reach.

[MakisH]

I think that in this project, almost all contributions will be minor by default, so why not add everyone by default. My concern would then be that there are people that contribute via issues: can we easily integrate these? Or do these then clearly fall into the same category as "We acknowledge private conversations with John Doe"? If we set the bar as low as a mention of a website, I see the danger that we would then constantly argue and just add more names.

The only pragmatic reason not to have a very long list of authors that don't really know each other could be what you observed with trying to find reviewer suggestions: it gets more complicated (in further publications) to find reviewers that have not published together with the authors. The "maximizing reach" argument is not necessarily true, I believe.

In terms of direct commits, there are very few so far, mostly in PRs suggesting additions: https://github.com/DE-RSE/learn-and-teach/graphs/contributors

In terms of the infrastructure and basic concepts/structure, my pull requests were typically reviewed by you and @jngrad, and the project evolved from discussions in our group, so I think this would be a fair starting point. The initial content I added was at large sourced from the competencies repository (mainly issues, see #11).

[CaptainSifff]

also mentioning over here: citation-file-format/citation-file-format#523