fix(docs): aktualisiere Installationsanweisungen und verbessere die Dokumentation

Author: sidey79

docs/01_user_guide/installation.adoc

@@ -1,4 +1,4 @@
-= Installation
+== Installation
 
 [NOTE]
 ====
@@ -31,7 +31,9 @@ Die einfachste Methode ist die Installation aus dem geklonten Repository im Entw
 
 [source,bash]
 ----
-include::../examples/bash/install_via_pip.sh[]
+git clone https://github.com/Ein-Einfaches-Beispiel/PySignalduino.git
+cd PySignalduino
+pip install -e .
 ----
 
 Dadurch wird das Paket `signalduino-mqtt` in Ihrer Python-Umgebung installiert und alle Runtime-Abhängigkeiten werden erfüllt.
@@ -42,7 +44,7 @@ Falls Sie das Paket nicht installieren, sondern nur die Abhängigkeiten nutzen m
 
 [source,bash]
 ----
-include::../examples/bash/install_requirements.sh[]
+pip install -r requirements.txt
 ----
 
 Die Datei `requirements.txt` enthält die gleichen Pakete wie oben aufgelistet.
@@ -53,7 +55,7 @@ Für Beiträge zum Projekt oder zum Ausführen der Tests installieren Sie zusät
 
 [source,bash]
 ----
-include::../examples/bash/install_dev_requirements.sh[]
+pip install -r requirements-dev.txt
 ----
 
 Dies installiert:
@@ -69,7 +71,7 @@ Dies installiert:
 
 [source,bash]
 ----
-include::../examples/bash/verify_installation.sh[]
+python3 main.py --help
 ----
 
 Sie sollten eine Ausgabe mit allen verfügbaren Kommandozeilenoptionen sehen.

docs/02_developer_guide/contribution.adoc

@@ -4,6 +4,7 @@
 ====
 Da PySignalduino noch in aktiver Entwicklung ist, können sich Code-Strukturen und APIs schnell ändern.
 Bitte synchronisieren Sie Ihren Fork regelmäßig mit dem upstream-Repository.
+====
 
 Beiträge zum Projekt sind willkommen!
 
@@ -52,11 +53,12 @@ Es gibt keine strikte CI-Prüfung, aber konsistenter Stil wird erwartet.
 Für alle AsciiDoc-Dateien im `docs/` Verzeichnis ist die Regel "Ein Satz pro Zeile" verpflichtend.
 Dies erleichtert die Überprüfung von Änderungen mittels `git diff`.
 
-[NOTE]
+[IMPORTANT]
 ====
 Jeder Satz muss auf einer neuen Zeile beginnen.
 Ein Satz endet typischerweise mit einem Punkt (`.`), Ausrufezeichen (`!`) oder Fragezeichen (`?`).
 Achten Sie darauf, dass Codeblöcke und Tabellen nicht betroffen sind.
+====
 
 == Tests ausführen
 

docs/index.adoc

@@ -16,49 +16,46 @@ Dadurch werden verschiedenste proprietäre Funkprotokolle für die Nutzung in Sm
 Die verfügbare Hardware-Basis reicht von einfachen Arduino/nanoCUL-Lösungen bis hin zu erweiterten Varianten wie dem Maple-SignalDuino und dem ESP32-SignalDuino, die erweiterte Funktionen (z.B. WLAN) bieten.
 
 .Übersicht: Hardware und Funktion
-[NOTE]
-====
 
 [mermaid]
 ----
 graph TD
-    subgraph Input (Funksignale)
+    subgraph "Input (Funksignale)"
         A[433/868 MHz Signale]
         B[Sensoren / Fernbedienungen]
     end
 
-    subgraph Hardware-Plattform
+    subgraph "Hardware-Plattform"
         C[CC1101 Funkmodul]
         D[Arduino Nano]
         E[ESP8266 / ESP32]
     end
 
-    subgraph PySignalduino (Software-Verarbeitung)
+    subgraph "PySignalduino (Software-Verarbeitung)"
         F[Empfangen / Senden]
         G[Protokolldemodulation]
-        H[Dekodierung (Protokolle)]
+        H[Dekodierung Protokolle]
     end
 
-    subgraph Output (Home Automation)
+    subgraph "Output (Home Automation)"
         I[MQTT Bridge]
         J[Serielle Schnittstelle]
         K[FHEM / Home Assistant / ioBroker]
     end
 
     A --> C
     B --> C
-    C -- Funksignale --> F
-    D -- Strom/Schnittstelle --> F
-    E -- Strom/Schnittstelle --> F
-
-    F -- Rohdaten --> G
-    G -- Demodulierte Daten --> H
-    H -- Decodierte Nachricht --> I
-    H -- Decodierte Nachricht --> J
+    C -- "Funksignale" --> F
+    D -- "Strom/Schnittstelle" --> F
+    E -- "Strom/Schnittstelle" --> F
+
+    F -- "Rohdaten" --> G
+    G -- "Demodulierte Daten" --> H
+    H -- "Decodierte Nachricht" --> I
+    H -- "Decodierte Nachricht" --> J
     I --> K
     J --> K
 ----
-====
 
 [[section-historie]]
 == Projektgeschichte und Entwicklung