adding illustrations; closes #459

Author: bast

content/browsing.md

@@ -42,6 +42,13 @@ by git.  A {term}`GitHub repository` is GitHub's copy, which adds
 things like access control.  Each GitHub repository is owned by a user
 or organization, who controls access.
 
+:::{figure} img/illustrations/fork.png
+:alt: Illustration of forking a repository on GitHub
+:width: 60%
+
+Illustration of forking a repository on GitHub.
+:::
+
 First, we need to make **our own copy** of the exercise repository. This will
 become important later, when we make our own changes.
 

content/commits.md

@@ -38,6 +38,14 @@ can merge them together easily.  Image created using <https://gopherize.me/>
 
 ## Exercise
 
+:::{figure} img/illustrations/branches.png
+:alt: Illustration of what we want to achieve in this exercise
+:width: 60%
+
+Illustration of what we want to achieve in this exercise.
+:::
+
+
 We offer **three different paths** of how to do this exercise.  For
 the CodeRefinery workshop day 1, we use and demonstrate the **GitHub
 path** only and recommend you do that

content/img/illustrations/branches.png

@@ -19,6 +19,14 @@ do, so now we move to working on your own computer.
 
 ## What is in a Git repository and what are we cloning?
 
+:::{figure} img/illustrations/clone.png
+:alt: Illustration of cloning a repository to a local computer
+:width: 60%
+
+Illustration of cloning a repository to a local computer.
+:::
+
+
 **Git repository**:
 - Contains all the files and directories of a project.
 - Contains the complete history of all changes (commits) to these files and directories.

content/img/illustrations/clone.png

@@ -36,6 +36,15 @@ the {term}`upstream` recipe book - which shows the true purpose of this.  But
 this is only a preview and we will practice collaboration much more in the
 [collaborative Git lesson](https://coderefinery.github.io/git-collaborative/).
 
+
+:::{figure} img/illustrations/merging.png
+:alt: Illustration of what we want to achieve in this exercise
+:width: 60%
+
+Illustration of what we want to achieve in this exercise.
+:::
+
+
 We offer **three different paths** of how to do this exercise.  For
 the CodeRefinery workshop day 1, we use and demonstrate the **GitHub
 path** only and recommend you do that.  The exercise text below has

content/img/illustrations/drawing.svg

@@ -18,6 +18,15 @@
 
 ## Exercise
 
+
+:::{figure} img/illustrations/sharing.png
+:alt: Illustration of how we turn a project into a Git repository and share it
+:width: 100%
+
+From a bunch of files to a local repository which we then share on GitHub.
+:::
+
+
 :::::{exercise} Exercise: Turn your project to a Git repo and share it (25 min)
 
 1. Create a new directory called **myproject** with one or few files in it.