From 7897a5149bd2af61d8c3b5f7feade078cb26da19 Mon Sep 17 00:00:00 2001
From: Martin Schroschk <martin.schroschk@tu-dresden.de>
Date: Thu, 2 May 2024 12:31:20 +0200
Subject: [PATCH] Turn code block into example with desc.

---
 .../docs/contrib/content_rules.md               | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/doc.zih.tu-dresden.de/docs/contrib/content_rules.md b/doc.zih.tu-dresden.de/docs/contrib/content_rules.md
index e8049f037..6c88d66eb 100644
--- a/doc.zih.tu-dresden.de/docs/contrib/content_rules.md
+++ b/doc.zih.tu-dresden.de/docs/contrib/content_rules.md
@@ -338,12 +338,17 @@ The table also holds a second placeholder, if, e.g., you need a second login to
 | Workspace title | `number_crunch` | `long_computations` |
 {: summary="Generic placeholders", align="bottom"}
 
-```console
-marie@login$ ls -l
-drwxr-xr-x   3 marie p_number_crunch      4096 Jan 24  2020 code
-drwxr-xr-x   3 marie p_number_crunch      4096 Feb 12  2020 data
--rw-rw----   1 marie p_number_crunch      4096 Jan 24  2020 readme.md
-```
+!!! example "Output of `ls` command"
+
+   The following code listing depicts the usage of the generic user names and projects as well as
+    recognizable placeholders for files and directory names.
+
+    ```console
+    marie@login$ ls -l
+    drwxr-xr-x   3 marie p_number_crunch      4096 Jan 24  2020 code
+    drwxr-xr-x   3 marie p_number_crunch      4096 Feb 12  2020 data
+    -rw-rw----   1 marie p_number_crunch      4096 Jan 24  2020 readme.md
+    ```
 
 !!! info "Marie"
 
-- 
GitLab