Version control with Git

Last updated: January 4, 2023

 Table of contents

Abstract

This day-long workshop introduces version control with Git and covers the most common operations. It puts a particular emphasis on explaining the functioning of Git: understanding what commands really do brings the confidence to go beyond the limited use of "add, commit, push" so common in data science fields.

Workshop requirements

1 - Git
    You can download Git here if you are on Windows and here if you use MacOS or Linux.

2 - GitLab account
    You can create a free GitLab account here.

Workshop material

This workshop is run by doing live coding within a RISE presentation from a Jupyter notebook.

With this format, making the material available outside of the actual workshop is not easy. Below are various formats, each with their pros and cons.

Binder

The presentation can be accessed and interacted with through Binder:

This preserves the full functionality of the RISE presentation, but it takes some time to load. As binder is quite slow, it may be best to stick to watching the presentation (by pressing the Space bar) rather than trying to run the code.

Pdf

The presentation is also available as a pdf. While this preserves the formatting, the hyperlinks are not active on this pdf and the code is not easy to copy if you want to copy/paste.

Html
Finally, it is available as a simple html. This format is fast (unlike Binder), has code easy to copy and working hyperlinks (unlike the pdf), but it does not have the reveal.js fancy formatting of the other options.

Comments & questions