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

README.md

@@ -2,24 +2,6 @@
 
 Dieses Projekt ist eine moderne Python-Implementierung der SIGNALDuino-Protokolle mit vollständiger **asyncio**-Unterstützung und integrierter **MQTT-Bridge**. Es ermöglicht die Kommunikation mit SIGNALDuino-Hardware (über serielle Schnittstelle oder TCP) und veröffentlicht empfangene Signale sowie empfängt Steuerbefehle über MQTT.
 
-## Projektgeschichte
-
-PySignalduino ist Teil des **RFD-FHEM**-Ökosystems, das ursprünglich als Perl-basierte Lösung für die Hausautomationssoftware FHEM begann. Die Entwicklung lässt sich in folgende Meilensteine unterteilen:
-
-### Ursprung: RFD-FHEM und SIGNALDuino
-- **2010er Jahre**: Die RFD-FHEM-Community entwickelte Hardware- und Softwarelösungen für die Funkkommunikation mit 433/868 MHz Geräten.
-- **SIGNALDuino-Hardware**: Ein Arduino-basierter Transceiver mit CC1101 Funkmodul, der als kostengünstige Alternative zu kommerziellen Lösungen entstand.
-- **Perl-Implementierung**: Die ursprüngliche Protokollimplementierung erfolgte in Perl als FHEM-Modul `00_SIGNALduino.pm`.
-
-### Migration zu Python
-- **2020er Jahre**: Mit der wachsenden Popularität von Python und MQTT entstand der Bedarf nach einer moderneren, asynchronen Lösung.
-- **PySignalduino**: Diese Bibliothek portiert die Perl-Protokolle (`SD_Protocols.pm`, `SD_ProtocolData.pm`) in eine native Python-Implementierung.
-- **Asynchrone Architektur**: Vollständige `asyncio`-Integration für bessere Performance und einfachere Integration in moderne IoT-Systeme.
-
-### Community-Entwicklung
-- **Open Source**: Das Projekt wird von einer aktiven Community auf GitHub gepflegt und weiterentwickelt.
-- **Firmware-Entwicklung**: Die SIGNALDuino-Firmware wird parallel im Repository [RFD-FHEM/SIGNALDuino](https://github.com/RFD-FHEM/SIGNALDuino) entwickelt.
-- **Version 3.5.0**: Die aktuelle Firmware-Version bietet erweiterte Funktionen wie WiFi-Unterstützung für ESP32-basierte Boards.
 
 ### Entwicklungsstatus
 

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)