feat: Update documentation to enhance clarity and include Architecture Decision Records

Author: sidey79

.github/workflows/docs.yml

@@ -31,7 +31,7 @@ jobs:
       - name: run asciidoctor with Kroki extension
         # Registriere die Kroki-Extension (-r asciidoctor-kroki) und aktiviere sie (-a kroki=). 
         # Mermaid-Diagramme werden mit dem Kroki-Server gerendert.
-        run: asciidoctor -R docs -D build/site/html -a docinfo=shared -a toc=left -a toclevels=2 -r asciidoctor-kroki -a kroki= 'docs/index.adoc'
+        run: find docs -type f -name "*.adoc" -exec asciidoctor -D build/site/html -a docinfo=shared -a toc=left -a toclevels=2 -r asciidoctor-kroki -a kroki= {} \;
 
       - name: Setup Python for Sitemap Generation
         uses: actions/setup-python@v5

docs/01_user_guide/installation.adoc

@@ -86,6 +86,6 @@ Details finden Sie in der [DevContainer-Dokumentation](devcontainer_env.md).
 
 Nach der Installation können Sie:
 
-1. Die [Schnellstart-Anleitung](../index.adoc#_schnellstart) befolgen.
-2. Die [Konfiguration über Umgebungsvariablen](../usage.adoc#_konfiguration) einrichten.
-3. Die [MQTT-Integration](../usage.adoc#_mqtt_integration) testen.
+* Die xref:#_schnellstart[Schnellstart-Anleitung] befolgen.
+* Die xref:#_konfiguration[Konfiguration über Umgebungsvariablen] einrichten.
+* Die xref:#_mqtt_integration[MQTT-Integration] testen.

docs/02_developer_guide/architecture.adoc

@@ -95,8 +95,14 @@ Alle Requests (Commands) und Responses (Responses/Errors) verwenden eine standar
 ----
 
 === Wichtige Architekturentscheidungen
-* link:../architecture/decisions/adr-001-mqtt-topic-structure.md[ADR-001: MQTT Topic Struktur und Versionierung]
-* link:../architecture/decisions/adr-002-command-dispatcher.md[ADR-002: Command Dispatcher Pattern und JSON-Schema-Validierung]
+Die vollständigen Architecture Decision Records (ADR) sind hier aufgelistet und werden im Dokument eingebettet:
+
+// ADRs 001 bis 005 werden direkt eingebunden
+include::../architecture/decisions/ADR-001-mqtt-get-frequency.adoc[leveloffset=+1]
+include::../architecture/decisions/ADR-002-mqtt-command-dispatcher.adoc[leveloffset=+1]
+include::../architecture/decisions/ADR-003-cc1101-parameter-set-logic.adoc[leveloffset=+1]
+include::../architecture/decisions/ADR-004-mqtt-response-parsing.adoc[leveloffset=+1]
+include::../architecture/decisions/ADR-005-mqtt-cc1101-response-consistency.adoc[leveloffset=+1]
 
 == Komponentendiagramm (Übersicht)