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.
We explain the main terminology of Git based on 5 important tasks:
The morning session is provided using slideshows, split in two main sections:
We like to thank Alice Bartlett, as her git-for-humans talk, was a major source of inspiration to the course material.
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:
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.
The course is written as a combination of
.Rmd files (in
src) and rendered using the
rmarkdown package. Rendering the course webpage can be done using the command (assuming an Rstudio project in the main repo folder):
And the resulting
html pages are updated to the
docs folder. The
docs folder of the main is used to deploy the Github pages.
The source for the Git and GitHub presentations are Google Presentations by @stijnvanhoey and @peterdesmet. In the directory
slideshow, there are a number of presentations not yet converted to course pages.