docs: README minimiert, docs/-Ordner mit Schnellstart, Installation, Verwendung, Beispielen, Fehlerbehandlung und technischen Details angelegt

docs/README.md

@@ -0,0 +1,13 @@
+# Dockernet Inspector – Dokumentation
+
+Willkommen in der Dokumentation des **Dockernet Inspectors**.
+
+## Inhaltsverzeichnis
+
+| Dokument | Beschreibung |
+|----------|--------------|
+| [Installation](installation.md) | Voraussetzungen, Klonen und Einrichtung |
+| [Verwendung](usage.md) | Modi, Befehle und Optionen |
+| [Beispiele](examples.md) | Ausgabe-Beispiele zu allen Befehlen |
+| [Fehlerbehandlung](error-handling.md) | Fehlermeldungen und deren Bedeutung |
+| [Technische Details](technical.md) | Voraussetzungen und verwendete Tools |

docs/error-handling.md

@@ -0,0 +1,19 @@
+# Fehlerbehandlung
+
+## CLI-Modus
+
+| Situation | Fehlermeldung |
+|-----------|---------------|
+| Kein Netzwerkname bei `inspect` | `Fehler: Netzwerkname erforderlich. Verwendung: $0 inspect <docker-network-name>` |
+| Kein Netzwerkname bei `ips` | `Fehler: Netzwerkname erforderlich. Verwendung: $0 ips <docker-network-name>` |
+| Netzwerk nicht gefunden | `Fehler: Netzwerk '<name>' nicht gefunden.` |
+| Docker nicht erreichbar | `Fehler: Docker Netzwerke konnten nicht abgerufen werden.` |
+
+## Interaktiver Modus
+
+| Situation | Fehlermeldung |
+|-----------|---------------|
+| Ungültige Menü-Eingabe | `FEHLER: Ungueltige Eingabe. Bitte geben Sie eine Nummer zwischen 0 und 4 ein.` |
+| Keine Netzwerke vorhanden | `Fehler: Keine Docker Netzwerke gefunden.` |
+
+Bei ungültigen Eingaben im interaktiven Modus bricht das Script nicht ab – der Nutzer kann die Eingabe korrigieren.

docs/examples.md

@@ -0,0 +1,62 @@
+# Ausgabe-Beispiele
+
+## `networks`
+
+```text
+Verfügbare Docker Netzwerke:
+================================================================================
+ID                          NAME      DRIVER    SCOPE
+------------------------------------------------------------------------------------
+abcd1234efgh5678ijkl9012    bridge    bridge    local
+mnop4567qrst8901uvwx2345    host      host      local
+yzab3456cdef7890ghij1234    mynet     bridge    local
+```
+
+## `inspect`
+
+```text
+Docker-Netzwerk   : my-network
+Driver            : bridge
+Bridge-Interface  : br-1234567890ab
+Subnet/Gateway    : 172.18.0.0/16 / 172.18.0.1
+OperState         : up
+RX bytes/packets  : 123456 / 789
+TX bytes/packets  : 654321 / 456
+```
+
+## `ips`
+
+```text
+Belegte IP-Adressen im Netzwerk 'dockernet':
+================================================================================
+CONTAINER   IP
+dozzle      172.16.0.95
+grafana     172.16.0.129
+```
+
+## `ips-all`
+
+```text
+Belegte IP-Adressen in allen Netzwerken (aufsteigend):
+================================================================================
+NETZWERK                       CONTAINER          IP
+dockernet                      dozzle             172.16.0.95
+datagerry.dockernetwork.local  datagerry-nginx    172.16.14.10
+matrixnetwork                  matrix-synapse-db  172.19.0.11
+```
+
+## Interaktives Menü
+
+```text
+================================================================================
+Dockernet Inspector - Interaktives Menü
+================================================================================
+
+1. Alle Netzwerke auflisten
+2. Detaillierte Infos zu einem Netzwerk
+3. IPs eines Netzwerks anzeigen
+4. Alle belegten IPs anzeigen
+0. Beenden
+
+Bitte waehlen Sie eine Option (0-4):
+```

docs/installation.md

@@ -0,0 +1,22 @@
+# Installation
+
+## Voraussetzungen
+
+- Docker ist installiert und läuft
+- Bash (Version 4+ empfohlen)
+- Linux-Host (für `/sys/class/net/` beim `inspect`-Befehl)
+
+## Einrichtung
+
+1. Repository klonen:
+
+```bash
+git clone https://git.techniverse.net/scriptos/dockernet-inspector.git
+cd dockernet-inspector
+```
+
+2. Script ausführbar machen:
+
+```bash
+chmod +x dockernet-inspector.v1.sh
+```

docs/technical.md

@@ -0,0 +1,17 @@
+# Technische Details
+
+## Voraussetzungen
+
+- Docker ist installiert und läuft
+- Bash Version 4+
+- Linux-Host (für `/sys/class/net/` beim `inspect`-Befehl)
+
+## Verwendete Tools
+
+| Tool | Zweck |
+|------|-------|
+| `docker network ls` | Alle Netzwerke auflisten |
+| `docker network inspect` | Netzwerk-Details abfragen |
+| `sort -V` | Natürliche IP-Sortierung |
+| `column -t -s $'\t'` | Dynamisch ausgerichtete Tabellenausgabe |
+| `/sys/class/net/` | Interface-Status und RX/TX-Statistiken |

docs/usage.md

@@ -0,0 +1,50 @@
+# Verwendung
+
+Das Script kann auf zwei Arten verwendet werden.
+
+## Interaktiver Modus (Menü)
+
+```bash
+bash ./dockernet-inspector.v1.sh
+```
+
+Das Script startet ein interaktives Menü mit folgenden Optionen:
+
+- **1** – Alle Netzwerke auflisten
+- **2** – Detaillierte Infos zu einem Netzwerk (mit Netzwerk-Auswahl)
+- **3** – IPs eines Netzwerks anzeigen (mit Netzwerk-Auswahl)
+- **4** – Alle belegten IPs anzeigen
+- **0** – Beenden
+
+Bei den Optionen **2** und **3** wird eine Netzwerkliste angezeigt, aus der per Nummer ausgewählt werden kann.
+
+## Kommandozeilen-Modus (CLI)
+
+```bash
+bash ./dockernet-inspector.v1.sh [BEFEHL] [OPTIONEN]
+```
+
+### Verfügbare Befehle
+
+| Befehl | Beschreibung |
+|--------|--------------|
+| *(keine)* | Startet den interaktiven Modus |
+| `networks` | Listet alle verfügbaren Docker-Netzwerke auf |
+| `inspect <netzwerk>` | Zeigt detaillierte Informationen zu einem Netzwerk |
+| `ips <netzwerk>` | Zeigt alle belegten IPv4-Adressen im angegebenen Netzwerk |
+| `ips-all` | Zeigt alle belegten IPv4-Adressen in allen Docker-Netzwerken (aufsteigend sortiert) |
+| `<netzwerk>` | Alias für `inspect <netzwerk>` (Rückwärtskompatibilität) |
+| `help`, `-h`, `--help` | Zeigt die Hilfe an |
+
+### Kurzbeispiele
+
+```bash
+bash ./dockernet-inspector.v1.sh networks
+bash ./dockernet-inspector.v1.sh inspect bridge
+bash ./dockernet-inspector.v1.sh my-custom-network
+bash ./dockernet-inspector.v1.sh ips dockernet
+bash ./dockernet-inspector.v1.sh ips-all
+bash ./dockernet-inspector.v1.sh help
+```
+
+Ausführliche Ausgabe-Beispiele sind in [examples.md](examples.md) zu finden.