Training course

Get into Git: one-day workshop on collaboration with Git

This workshop introduces version control with git and teaches you how to collaborate using git and GitLab.

Knowing how to use git and GitLab will allow you to keep track of changes in your software project, publish your code online, collaborate with several people on the same project, and contribute to projects as an external collaborator. This free workshop is open to WUR researchers and PhD candidates.

Organised by Library
Date

Tue 10 December 2024 09:00 to 16:30

Venue Forum, building number 102
Droevendaalsesteeg 2
102
6708 PB Wageningen
+31 (0) 317 - 482160
Room B0508

Registration

For this workshop, registration is mandatory. Please fill in this form and you'll get an invitation to the workshop. We can only have up to 35 people join. After reaching maximum capacity, we will maintain a waiting list.

About the course

Git is a protocol for collaborative software version control. Using Git to manage your code lets you track changes and collaborate with multiple colleagues on the same project. It is a crucial and widely used standard both in large tech companies and many open-source communities. In scientific programming, Git is also the standard; therefore, this skill is highly relevant for all scientific fields.

Researchers and students at WUR have access to the Gitlab service at https://git.wur.nl, a server on which source code can be shared and edited through the Git protocol. The workshop is organised by WUR Library and will be given by certified instructors from the eScience Center, based on the Software Carpentries curriculum.

Practicalities

  • Level: beginner & intermediate. It is assumed that participants already write code for their research, but no expertise is required. Some experience in navigating file trees and editing files in a terminal/command prompt session, for example using nano, is recommended.

  • Language: English
  • Max number of participants: 35
  • Cost: no costs for WUR researchers en PhDs
  • Lunch, coffee and tea are included
  • Requirements: Participants must bring a laptop with a Mac, Linux, or Windows operating system (not a tablet, Chromebook, etc.) that they have administrative privileges on. They should have a few specific software packages installed.

Syllabus

Introduction to version control with Git

  • Tracking changes: git add & git commit
  • Exploring history, checking out older versions
  • Ignoring things with .gitignore files
  • Github remotes

Collaboration with Git and GitLab

  • Creating pull requests
  • Review process
  • Good practices for collaboration
  • Contributing to repositories with forks

Setup

To participate in this workshop, you will need access to software as described below. In addition, you will need an up-to-date web browser.

We maintain a list of common issues that occur during installation as a reference for instructors that may be useful on the Configuration Problems and Solutions wiki page.

  • Install Shell and Git. Please refer to this page for installation instructions.
  • Set up an SSH connection to GitLab. First check if you have an ssh key. Then create an SSH key pair if you don't have one, please refer to this page for instructions. Then add the SSH key to your GitLab account following these instructions.
  • You can then verify the SSH connection by running `ssh -T git@git.wur.nl` inside your terminal (for example Git Bash). The terminal will ask: 'Are you sure you want to continue connecting'. Respond with 'yes'.
  • If you see 'Welcome to GitLab, username' you are succesfully setup! Otherwise send an email to training@esciencecenter.nl and we will help you with your setup.