From f78d200400a4f3b55e1c1db7be3fcf181190260f Mon Sep 17 00:00:00 2001
From: "Uwe Jandt (DESY)" <uwe.jandt@desy.de>
Date: Fri, 28 May 2021 15:43:25 +0200
Subject: [PATCH] reshape start of text

---
 ...5-26-diagrams-from-textual-descriptions.md | 24 +++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/_posts/2021/05/2021-05-26-diagrams-from-textual-descriptions.md b/_posts/2021/05/2021-05-26-diagrams-from-textual-descriptions.md
index 09cee643f..d727e3893 100644
--- a/_posts/2021/05/2021-05-26-diagrams-from-textual-descriptions.md
+++ b/_posts/2021/05/2021-05-26-diagrams-from-textual-descriptions.md
@@ -16,9 +16,17 @@ excerpt: >
 
 {{ page.excerpt }}
 
-## Quick-Start Example
-Let us jump right in with an example by creating a UML sequence diagram.
-Any of these examples can be used in a place on <https://gitlab.hzdr.de>
+
+
+
+## What is it about and where can it be applied?
+Gitlab is perfect for colloborative work on codes, scripts and other shared files.
+Now you can also create virtually all sorts of diagrams and sketches directly in Gitlab,
+both allowing to quickly create plots, as well as
+collaboratively build and maintain complex graphs.
+
+All graphs are built from simple scripts directly in Gitlab using a plugin named [Kroki](https://kroki.io/).
+Any of such scripts can be used in a place on the [Helmholtz-wide Gitlab](https://gitlab.hzdr.de)
 where Markdown is supported:
   * Comments
   * Issues
@@ -28,7 +36,15 @@ where Markdown is supported:
   * Wiki pages
   * Markdown documents inside repositories
 
-Therefore, put this content describing the diagram in any of the items
+<a href="."
+                            class="btn btn-outline-secondary"
+                            title="Link to examples in Gitlab"> 
+                            <i class="fas fa-lightbulb"></i> Click here for examples in Gitlab! <i class="fas fa-lightbulb"></i></a>
+
+## Quick-Start Example
+Let us jump right in with an example by creating a UML sequence diagram.
+
+Put this content describing the diagram in any of the items
 listed above.
 
     ```plantuml
-- 
GitLab