From 3dbfa55957c36e1dad84cd72339cbf3d442212d6 Mon Sep 17 00:00:00 2001
From: Martin Schroschk <martin.schroschk@tu-dresden.de>
Date: Wed, 6 Dec 2023 13:26:52 +0100
Subject: [PATCH] Add example w.r.t. searching software

---
 .../docs/software/modules.md                  | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/doc.zih.tu-dresden.de/docs/software/modules.md b/doc.zih.tu-dresden.de/docs/software/modules.md
index 90a457488..d120615a3 100644
--- a/doc.zih.tu-dresden.de/docs/software/modules.md
+++ b/doc.zih.tu-dresden.de/docs/software/modules.md
@@ -40,6 +40,41 @@ certain module, you can use `module avail softwarename` and it will display the
 
 ### Examples
 
+???+ example "Searching for software"
+
+    The process of searching for a particular software you want to use on an HPC system consits of
+    two steps: Login to the target HPC system and invoke `module spider` command to search for the
+    software and list available versions.
+
+    For example, if you want to search for available Matlab versions on `Barnard`, the steps might
+    be:
+
+    ```console
+    marie@login.barnard module spider matlab
+
+---------------------------------------------------------------------------------------------------------------------------------------------------------
+  MATLAB: MATLAB/2022b
+---------------------------------------------------------------------------------------------------------------------------------------------------------
+    Description:
+      MATLAB is a high-level language and interactive environment that enables you to perform computationally intensive tasks faster than with
+      traditional programming languages such as C, C++, and Fortran.
+
+
+    You will need to load all module(s) on any one of the lines below before the "MATLAB/2022b" module is available to load.
+
+      release/23.04
+      release/23.10
+      [...]
+    ```
+
+    As you can see, `MATLAB` in version `2022b` is available on Barnard within the releases `23.04`
+    and`23.10`. Additonally, the output provides the information how to load it:
+
+    ```console
+    marie@login.barnard$ module load release/23.10 MATLAB/2022b
+    Module MATLAB/2022b and 1 dependency loaded.
+    ```
+
 ???+ example "Finding available software"
 
     This examples illustrates the usage of the command `module avail` to search for available Matlab
-- 
GitLab