Expand the tutorial and begin filling the gaps

ocaisa · ocaisa · commit ea897bc88f0b · 2026-06-04T16:39:33.000+02:00
diff --git a/docs/advanced-topics.md b/docs/advanced-topics.md
@@ -0,0 +1,9 @@
+# Customisation of EESSI
+
+## GPU drivers
+
+## MPI runtimes
+
+# Other software installation tools on top of EESSI
+
+## Spack
diff --git a/docs/building-on-top.md b/docs/building-on-top.md
diff --git a/docs/eessi-getting-access.md b/docs/eessi-getting-access.md
@@ -1,5 +1,11 @@
 # Getting Access to EESSI
 
+!!! Note "Learning Objectives"
+
+    * Learn how to check if EESSI is available
+    * Learn how to install EESSI locally if you have administrator permissions
+    * Learn how to start EESSI inside a container
+
 To get access to EESSI, it suffices to have [CernVM-FS](https://cernvm.cern.ch/fs/) installed, and make it aware
 of the EESSI repository.
 
diff --git a/docs/eessi-in-ci.md b/docs/eessi-in-ci.md
@@ -0,0 +1,30 @@
+# EESSI for Continuous Integration (CI)
+
+!!! Note "Learning Objectives"
+
+    * Integrate CI based on EESSI into our software project
+    * Navigate the CI interface of GitHub
+    * Consider the benefits of CI integration
+
+## What is Continuous Integration (CI)?
+
+## How can EESSI help with CI?
+
+
+### EESSI GitHub Action
+
+!!! Note "I use GitLab not GitHub"
+
+    The [EESSI GitLab Component]() also exists, and this allows you to follow a very similar approach to that described
+    here for GitHub. At the end of the episode we will provide the equivalent file needed to enable GitLab CI.
+
+    It is possible to use the [EESSI GitLab Component]() in a private GitLab instance, documentation on how to do this
+    is available at <>. 
+
+## Adding CI based on EESSI to our software project
+
+### Where to find help?
+
+### What happens when CI fails?
+
+## Benefits of CI
diff --git a/docs/eessi-introduction.md b/docs/eessi-introduction.md
@@ -1,5 +1,11 @@
 # Introduction to EESSI
 
+!!! Note "Learning Objectives"
+
+    * Learn the basic layered architecture of EESSI
+    * Understand what open source software delivers each layer
+    * Explore some of the history of EESSI 
+
 <p align="center"><a href="https://eessi.github.io/docs"><img src="img/EESSI_logo_horizontal_transparant.png" alt="EESSI logo" width="450px"/></a></p>
 
 ## What is EESSI?
diff --git a/docs/eessi-usage.md b/docs/eessi-usage.md
@@ -1,5 +1,11 @@
 # Using EESSI
 
+!!! Note "Learning Objectives"
+
+    * Configure EESSI in your environment
+    * Explore the software that EESSI has to offer
+    * Run examples for some software packages included in EESSI
+
 If the EESSI repository is available, all you need to do is set up your shell environment,
 and you can start using the software installations that EESSI provides.
 
diff --git a/docs/eessi-use-cases.md b/docs/eessi-use-cases.md
@@ -1,5 +1,9 @@
 # Use Cases for EESSI
 
+!!! Note "Learning Objectives"
+
+    * Identify use cases for a fully reproducible environment like EESSI
+
 EESSI enables a variety of use cases, including:
 
 * A uniform, extensible software stack across HPC clusters, clouds, servers, and laptops
diff --git a/docs/img/GitHubRepo.png b/docs/img/GitHubRepo.png
diff --git a/docs/img/GitHubTemplate.png b/docs/img/GitHubTemplate.png
diff --git a/docs/index.md b/docs/index.md
@@ -16,6 +16,9 @@ EESSI provides a shared, portable, and optimized software stack for scientific c
 2. [Introduction to EESSI](eessi-introduction.md)
 3. [Using EESSI](eessi-usage.md)
 4. [EESSI Use Cases](eessi-use-cases.md)
+5. [Building on top of EESSI](building-on-top.md)
+6. [Using EESSI in CI](eessi-in-ci.md)
+7. [Advanced topics](advanced-topics.md)
 
 ## Learning Objectives
 
diff --git a/zensical.toml b/zensical.toml
@@ -50,6 +50,9 @@ nav = [
    { "What is EESSI?" = "eessi-introduction.md" },
    { "How to use EESSI" = "eessi-usage.md" },
    { "Use cases for EESSI" = "eessi-use-cases.md" },
+   { "Building on top of EESSI" = "building-on-top.md" },
+   { "Using EESSI in CI" = "eessi-in-ci.md" },
+   { "Advanced topics" = "advanced-topics.md" },
 ]
 
 # With the "extra_css" option you can add your own CSS styling to customize
