Added diagrams for documentation

.gitignore

@@ -73,3 +73,5 @@ Thumbs.db
 Desktop.ini
 
 compile_commands.json
+
+*.puml

docs/diagrams/.clang-uml

@@ -0,0 +1,62 @@
+compilation_database_dir: ../..
+output_directory: .
+diagrams:
+
+  includes:
+    type: include
+    relative_to: ../..
+    glob:
+      - src/*.cpp
+      - include/*.h
+    generate_system_headers: true
+    include:
+      paths:
+        - src
+        - include
+    plantuml:
+      before:
+        - 'skinparam linetype ortho'
+
+  includes_no_external:
+    type: include
+    relative_to: ../..
+    glob:
+      - src/*.cpp
+      - include/*.h
+    include:
+      paths:
+        - src
+        - include
+    plantuml:
+      before:
+        - 'skinparam linetype ortho'
+
+  classes:
+    type: class
+    relative_to: ../..
+    glob:
+      - src/*.cpp
+      - include/*.h
+    include:
+      paths:
+        - src
+        - include
+    plantuml:
+      before:
+        - 'skinparam linetype ortho'
+
+  load_map_example_sequence:
+    type: sequence
+    relative_to: ../..
+    glob:
+      - src/*.cpp
+      - include/*.h
+    include:
+      paths:
+        - src
+        - include
+    start_from:
+      - function: "Map::loadMap(const char *,int,int)"
+    plantuml:
+      before:
+        - 'skinparam linetype ortho'

docs/diagrams/howto.md

@@ -0,0 +1,12 @@
+Need [clang-uml](https://clang-uml.github.io/index.html)
+
+```sh
+clang-uml
+clang-uml --add-compile-flag -I/usr/lib/clang/16/include    # might need additional flags, example for my machine
+clang-uml --print-from -n load_map_example_sequence         # to get availabel commands for sequence diagram
+```
+
+then use plant uml to generate an actual `.svg` vector graphic
+```sh
+plantuml -tsvg *.puml
+```