Merge pull request #30 from t4d-gmbh/28-part-0-short-intro

28 part 0 short intro

README.md

@@ -1,6 +1,6 @@
 # Using Git in Academia
 
-A course for the casual git user...
+A seminar for the casual git user...
 
  <!-- readme-include -->
 ## Content
@@ -69,7 +69,7 @@ _That would be the end of part 1_
 ---
 
 
-### 3. Part: Continuous Integration and Delivery
+### 3. Part: [CI/CD Workflows](https://github.com/t4d-gmbh/ci-cd-workflows)
 
 #### Why remotes offer automation
 - Get an idea about the vast application possibilities of automation

source/conf.py

@@ -12,7 +12,7 @@
 
 
 project = 'Git in Academia'
-copyright = '2023-2024, T4D GmbH'
+copyright = '2023-2024; T4D GmbH'
 author = 'Jonas I. Liechti'
 # ###
 # Versioning - get it from the git tag
@@ -88,7 +88,7 @@
 }
 
 favicons = [
-    "_static/T4D_logo_bw.svg"
+    "T4D_logo.png"
 ]
 
 myst_enable_extensions = [

source/content/about/config.md

@@ -1,3 +1,5 @@
-## Tools
+## Setup
 
-- It will be advantageous if you have your laptop ready
+- Have your laptop ready.
+- Have an account on <i class="fab fa-github"></i> **GitHub** and any <i class="fab fa-gitlab"></i> **GitLab** instance.
+- Configure your <i class="fab fa-github"></i> **GitHub** account so you can use `ssh` (i.e. add an `ssh`-key to your account).

source/content/about/index.md

@@ -1,7 +1,11 @@
-# Premises
+# About this Seminar
 ```{toctree}
 :maxdepth: {% if build == "slides" %}1{% else %}2{% endif %}
+:numbered:
 
 ./syllabus
+{% if slide %}
 ./requirements
+./presenters
+{% endif %}
 ```

source/content/about/knowledge.md

@@ -1,8 +1,9 @@
 ## Prior knowledge
 
-- You should be familiar with the **git commands**:
+- You should be familiar with the <i class="fab fa-git"></i> **commands**:
   - `pull`
   - `push`
   - `commit`
 
-- Having heard of and used `GitHub` and `GitLab` is a plus
+
+- Familiarity with and experience using <i class="fab fa-github"></i> **GitHub** and <i class="fab fa-gitlab"></i> **GitLab** is an advantage.

source/content/about/presenters.md

@@ -0,0 +1,10 @@
+# Presenters
+
+::::{grid}
+:::{grid-item-card} @j-i-l
+![Jonas](./jonas_github.png)
+:::
+:::{grid-item-card} @matteodelucchi 
+![Matteo](./matteo_github.png)
+:::
+::::

source/content/about/requirements.md

@@ -1,18 +1,8 @@
 # Requirements
 
-{% if build == "slides" %}
-```{toctree}
-:maxdepth: 2
-:caption: Contents
-
-./knowledge
-./config
-```
-{% else %}
 ```{include} ./knowledge.md
 ```
 ```{include} ./config.md
 ```
-{% endif %}
 
 

source/content/about/syllabus.md

@@ -1,12 +1,27 @@
+{% if page %}
 # Syllabus
+{% else %}
+# Schedule
+{% endif %}
 
 {% if page %}
 ```{include} ../../../README.md
 :start-after: <!-- syllabus-include -->
 :end-before: <!-- syllabus-exclude-->
 ```
 {% else %}
-```{include} ../parts/index.md
-```
+:::{card} Day 1
+1. Part: **[Working with git](https://github.com/t4d-gmbh/working-with-git)**
+
+---
+2. Part: **[Git and its Remotes](https://github.com/t4d-gmbh/git-and-its-remotes)**
+
+:::
+:::{card} Day 2
+3. Part: **[CI/CD Workflows](https://github.com/t4d-gmbh/ci-cd-workflows)**
+
+---
+4. Part: **[Git and Science](https://github.com/t4d-gmbh/git-and-science)**
+:::
 {% endif %}
 

source/index.md

@@ -4,8 +4,9 @@
 
 ```{toctree}
 :caption: About
-:maxdepth: {% if build == "slides" %}0{% else %}2{% endif %}
+:maxdepth: {% if build == "slides" %}1{% else %}2{% endif %}
 {% if build == "slides" %}:numbered:
+:hidden:
 {% endif %}
 
 content/about/index
@@ -16,7 +17,7 @@ content/about/index
 {% endif %}
 ```{toctree}
 :caption: Working with Git
-:maxdepth: {% if build == "slides" %}0{% else %}2{% endif %}
+:maxdepth: {% if build == "slides" %}1{% else %}2{% endif %}
 {% if build == "slides" %}:numbered:
 :hidden:
 {% endif %}