/git-course

Course material for Git(hub) course at INBO

Primary LanguageCSS

INBO Git workshop

Introduction

At INBO, people do write code and require version control. As git is not the most straightforward environment to work with for non-IT specialists, we try to define our own sub-ecosystem with relevant practices and an achievable workflow.

In this repository, we collect the material for workshops and courses given by/for INBO people, but for other interested researchers/... as well.

A workshop typically takes a whole day, with the morning session focused on getting the concepts and terminology clear and an afternoon hands-on session.

Workshop content

Morning session

We explain the main terminology of Git based on 5 important tasks:

  1. Tell the story of your project
  2. Travel back in time
  3. Experiment with changes
  4. Backup your work
  5. Collaborate on projects

The morning session is provided using slideshows, split in two main sections:

We like to thank Alice Bartlett, as her git-for-humans talk, https://speakerdeck.com/alicebartlett/git-for-humans was a major source of inspiration to the course material.

Afternoon session

The content of the hands-on session in the afternoon depends on the audience of the workshop. Most of the people mainly work in Rstudio and it makes sense to use the integrated git-tools of Rstudio. Others are used to work in the command line or prefer Github Desktop to handle version control. As such, we have three similar sessions, targeted at the different audiences:

  • Using Git with GitHub desktop (under development)
  • Using Git with RStudio
  • Using Git with the command line (under development)

Setup

In order to follow the git-course, the main installation requirement is git itself. Further configuration is explained during the tutorial.

For the git through RStudio, an installation of R and Rstudio is expected as well. For the Github Desktop version, an installed version of Github Desktop.