The most relevant open questions concern authorship. CodeMeta distinguishes between "authors" and "contributors". Should we also distinguish? Who will be included? (How) do we automate the update of the file?
Add generic author (Dumux development team / Dumux developers) and list of contributors
0 of 1 checklist item completed
· Edited by
Timo Koch
Designs
Child items
...
Show closed items
Linked items
0
Link issues together to show that they're related.
Learn more.
Conclusion of the discussion, 25.10.2023:
After running the script getcontributors.sh, a manual decision has to be made and update the AUTHORS.md file. This file will serve as the basis for all author references for the release.
I don't think this answers this issue which is about the CodeMeta file. There it is distinguished between contributors and authors. authors.md lists all contributors. So it's not clear to me what the decision in your discussion was on?
To my understanding authors.md lists only the authors and we said people who contributed in a meaningful way are considered authors. People who only commited for example one small commit with a typo fix are not considered authors but contributors. Nevertheless, it might not always be clear what counts as a meaningful contribution. This might be up to the current release manager?
authors.md currently lists all contributors (that's at least what the first line states). Do we change this?
This issue is about CodeMeta, not about authors.md. The suggestion in the MR description is that there the author field will be "DuMux developer team" and the contributors field lists all contributors. Has this been discussed?
I don't know if CodeMeta is tied to a specific release. If yes then we could make such a distinction (authors are authors of the release, and contributors all other minor contributors)
We should change the first line to authors instead of contributors.
For the second point: we thought it might be best to list the content of authors.md in the author field and I guess the other contributors in the contributor field.
Making it release specific would make it possible to make this distinction, if it makes sense.
authors.md is about copyright. So you could exclude contributors that only changed a bit of whitespace or typos or some very small changes that are not enough to constitute intellectual property. Is that the idea? I think so far, we listed all commiters there.
there is no clear definitions for authors and contributors and we didn't have one / need one so far. (That's essentially what this issue is about because CodeMeta has two terms, BTW other formats like cff don't, see !2868). We only had committers and "randomly" called them authors or contributors in the source code. And we had authors of publications and zenodo releases (where the criterion was "significant" contribution). As far as I know.
Let us do it as discussed in !3101 (merged) and suggested by you: add "The DuMux development team" as "author" and each single name(?) from authors.md as contributor. Although, this does not allow release-specific lists, which might not be necessary though.