annalenalamprecht / paper_teaching-learning-rse

Output of the de-RSE 2023 Conference Workshop on "Teaching and Learning Research Software Engineering"

Paper: Teaching and Learning Research Software Engineering

Output of the de-RSE 2023 Conference Workshop on "Teaching and Learning Research Software Engineering".

Since the original idea grew in size and scope we had to split the paper in different subpapers highlighting different aspects

Get the latest version of the respective PDF files here:

• "Foundational competencies and responsibilities of an RSE" (competencies.pdf)
• "Institutionalized Organisation of RSE Education" (institutionalised_education.pdf)
• "A Survey of Initiatives Providing Educative Material in the RSE Space" (survey.pdf)
• "Educating RSEs in Germany - What Needs to Be Done" (call_to_action.pdf)

Older:

• "Teaching and Learning Research Software Engineering" (intro.pdf)

How to contribute - Some of our rules

This paper is intended as a collaborative effort and we are looking for input from you.

We follow GitLab/GitHub flow

Please utilise semantic line breaks!

We use British English

• competencies.md will be published on arxiv. LaTeX tags/code is fine in here.
• survey.md will move to a website, hence this file has to be Markdown
• We utilise tags to categorise issues and PRs to the respective paper.

You can contribute in various ways:

1. Propose content/text via pull request
2. Improve existing content via pull request
3. Review or comment on pull requests of others

To build the PDF files, we recommend a full TeXlive installation. You will also need to install a few Python packages:

python3 -m pip install -r requirements.txt

How to create a pull request

• Fork this repository
• Create your changes in your fork
• Go to the pull requests page of this repository and push new pull request
• You can add DRAFT, or WIP to indicate work-in-progress PRs.
• Add a short description

The community will review your pull request and may ask you for additional changes. If you have any questions, please don't hesitate to ask (we are trying to be as helpful as possible).

How to review existing pull requests

• Go to the pull requests page of this repository
• Click on any of the open pull requests
• Leave comments under Conversation or do a full review under Files changed

How to get credit

If you've contributed to this paper in any way, please add your name to contributors.yml using the template at the bottom of the file. Make sure the name provided in the "author:" field matches exactly with the name in the Markdown preamble author list.

Publication

We currently have split the topic of teaching RSEs in Germany across four papers. We aim for a publication of most of these papers. All people that have participated in discussions with us, e.g. at deRSE23 or undeRSE23 are at least eligible for contributor status. If you have participated regularly at our weekly working meetings you are eligible for authorship.