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:

Tell the story of your project
Travel back in time
Experiment with changes
Backup your work
Collaborate on projects

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

Git
GitHub

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.

Course development note

The course is written as a combination of .md and .Rmd files 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):

rmarkdown::render_site("src")

And the resulting html pages are updated to the docs folder. The docs folder of the master is used to deploy the Github pages.

License

lcdvissc/git-course

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages