Rework contribution section (#350)

* Acknowledgements and bibliography --------- Co-authored-by: Jean-Noël Grad <[email protected]> Co-authored-by: Magnus Hagdorn <[email protected]> Co-authored-by: Florian Goth <[email protected]> Co-authored-by: Jeremy Cohen <[email protected]> Co-authored-by: Frank Löffler <[email protected]> Co-authored-by: Gerasimos Chourdakis <[email protected]> Co-authored-by: Jan Philipp Thiele <[email protected]>
the-teachingRSE-project · Aug 12, 2024 · 391af17 · 391af17
1 parent 4d1eb38
commit 391af17
Show file tree

Hide file tree

Showing 5 changed files with 55 additions and 9 deletions.
diff --git a/.github/spellignore.txt b/.github/spellignore.txt
@@ -6,6 +6,8 @@ artifacts
 aspirational
 backend
 Badging
+Bernhard
+BibTeX
 BioExcel
 BIOEXCEL-FRAMEWORK
 bioinformatician
@@ -27,6 +29,7 @@ CodeMeta
 CodeRefinery
 comp-lvls-techn
 Coursera
+CRediT
 CRSP
 CSE
 curation
@@ -89,6 +92,7 @@ GPL
 habilitation
 HAI
 Hannay
+Hasselbring
 HIDA
 HIFIS
 HMC
@@ -155,6 +159,7 @@ RSE
 RSE's
 rse-specialisations
 RTPs
+Rumpe
 scalable
 scipy
 SeniorCC

diff --git a/bibliography b/bibliography
diff --git a/competencies.md b/competencies.md
@@ -93,6 +93,11 @@ keywords:
   - competencies
   - curriculum design
   - teaching
+acknowledgements-before: ""
+acknowledgements-after: "
+We appreciate the comments and suggestions from Yves Vincent Grossmann,
+Wilhelm Hasselbring, and Bernhard Rumpe.
+"
 abstract: "
 The term Research Software Engineer, or RSE,
 emerged a little over 10 years ago as a way to represent
@@ -1503,20 +1508,50 @@ How we update existing institutions and set up new ones
 that provide this education will be the topic of a follow-up paper.
 
 # Contribution details {-}
-Heidi Seibold came up with the original idea for the deRSE23 workshop.
+
+Heidi Seibold came up with the original idea for the deRSE23 workshop in Paderborn.
+Heidi Seibold, Jeremy Cohen, Florian Goth, Renato Alves, Jan Philipp Thiele, and Samantha Wittke organised the deRSE23 workshop.
 We thank all the participants of this community workshop!
-Heidi Seibold, Jeremy Cohen, Florian Goth, Renato Alves, Jan Philipp Thiele,
-and Samantha Wittke organised the deRSE23 workshop.
-Toby Hodges conceptualised and organised the un-deRSE23 workshop.
+Toby Hodges conceptualised and organised the un-deRSE23 workshop together with Jan Philipp Thiele and Florian Goth.
 We also thank all the participants of this follow-up community workshop!
-
+Jeremy Cohen, Gerasimos Chourdakis, Magnus Hagdorn, Jean-Noël Grad, Jan Philipp Thiele, and Matthias Braun organised the deRSE24 workshop in Würzburg.
+We are also grateful to the participants of this third community workshop!
 Heidi Seibold, Jeremy Cohen, Florian Goth, Renato Alves, Jan Philipp Thiele,
 Jan Linxweiler, Jean-Noël Grad, and Samantha Wittke contributed the initial draft.
 Florian Goth supervised the project and did the project administration.
-Jean-Noël Grad designed and implemented the software tooling.
-Michele Martone wrote the first draft of the environmental sustainability section.
+Jean-Noël Grad designed and implemented the software tooling for the collaborative writing of this manuscript on GitHub.
 Everybody contributed to the final review and editing.
 
+
+The CRediT system [@Brand2015] is far too generic to adequately describe the contributions of everybody in various workshops, spread over a two year period.
+While everybody contributed to the discussion formulating and refining the ideas, and to collaboratively writing and/or reviewing and editing the entirety the script, some parts merit special mention.
+Renato Alves quickly jumped in to host the first deRSE23 workshop to take over from a sick organiser.
+Matthias Braun contributed early versions of the specialisations and also contributed to the survey.
+Leyla Jael Castro contributed to the initial draft of the example career path, and provided helpful insights in discussions on metadata.
+Gerasimos Chourdakis' contributions to the paper are numerous (extensively editing large parts of the initial draft), but he especially wrote first drafts for clarifying
+the relationship of the RSE competencies to the SE competencies. He also designed the "Learning and teaching RSE" website [@learnandteach].
+Simon Christ helped with typesetting and contributed the competencies' symbols and the spell-checker script.
+Jeremy Cohen drafted the initial introduction and contributed the tables for RSEs in centralised RSE departments.
+Stephan Druskat contributed parts on proper software citation and publication and sharpened various RSE specialisations.
+Fredo Erxleben contributed to early discussions of the paper and added the contributions by the Helmholtz Association.
+Jean-Noël Grad contributed initial drafts for the ELIXIR framework and the section on the work of the HPC certification forum
+as well as numerous other contributions to the BibTeX infrastructure and the GitHub actions.
+Magnus Hagdorn drafted and supervised the ethics and values section for an RSE and made sure that these values are reflected in the competencies of RSEs.
+Toby Hodges contributed parts on the Carpentries, and helped steer the curriculum discussion.
+Guido Juckeland contributed experiences from his first RSE course for students.
+Dominic Kempf drafted the first version of the example curriculum.
+Anna-Lena Lamprecht helped with proper wording, especially with awareness about established SE terminology, that was misused earlier.
+Jan Linxweiler drafted various RSE specialisations and made sure that clean coding techniques got their due recognition.
+Frank Löffler rewrote numerous parts to be actually legible, and helped with preparation for the final steps of a de-RSE position paper.
+Michele Martone wrote the first draft of the environmental sustainability section.
+Moritz Schwarzmeier drafted the categorisation of the specialisations.
+Heidi Seibold contributed the idea and started everything.
+Jan Philipp Thiele drafted initial parts of the technical pillar of the RSE competencies, and represented the project on numerous discussions.
+Harald von Waldow contributed to initial drafts of the Masters program and contributed his knowledge to the explainability of computer simulations.
+Samantha Wittke contributed the parts on CodeRefinery and how to reach out to new RSEs.
+Florian Goth has the pleasure of being grateful to all collaborators in this project for contributing their time and knowledge into this project!
+
+
 \appendix
 
 

diff --git a/contributors.yml b/contributors.yml
@@ -244,7 +244,7 @@ authors:
     orcid: 0000-0003-3239-8554
     email: [email protected]
     acknowledgements: |
-      MM acknowledges funding from the SiVeGCS Project
+      MM acknowledges funding from the SiVeGCS Project.
 
 # please use the following author template (all fields are optional):
 

diff --git a/filter.py b/filter.py
@@ -50,6 +50,9 @@ def process_markdown(metadata, body, contributors):
     acknowledgements = ["# Acknowledgements {- #sec:acknowledgements}"]
     bookkeeping_initials = {}
     author_thanks = get_author_thanks(metadata)
+    if "acknowledgements-before" in metadata:
+        acknowledgements.append(metadata["acknowledgements-before"])
+        del metadata["acknowledgements-before"]
     # parse metadata
     for fullname, annotations in author_thanks.items():
         author_metadata = contributors[fullname]
@@ -75,6 +78,9 @@ def process_markdown(metadata, body, contributors):
             assert initials in message, f"'{initials}' doesn't appear in the acknowledgements of '{fullname}'"
             acknowledgements.append(message)
     affiliations_tex = [f"\\affil[{key}]{{{affil}}}" for affil, key in affiliations.items()]
+    if "acknowledgements-after" in metadata:
+        acknowledgements.append(metadata["acknowledgements-after"])
+        del metadata["acknowledgements-after"]
     # update Markdown metadata
     del metadata["author"]
     metadata["authorxmp"] = authors_xmp