Document edition installation and update workflow

README.md

@@ -31,6 +31,38 @@ python3 scripts/publish_packages.py --tea-login Building
 
 DEB-Pakete werden in die Distribution `thueringen`, RPM-Pakete in die Gruppe `thueringen` veröffentlicht. Dadurch bleiben auch die Paketquellen von der Standard Edition getrennt.
 
+## Über APT installieren
+
+```bash
+sudo install -d -m 0755 /etc/apt/keyrings
+sudo curl -fsSL https://git.blackwall.ipv64.de/api/packages/pan/debian/repository.key \
+  -o /etc/apt/keyrings/pan-gitea.asc
+echo "deb [signed-by=/etc/apt/keyrings/pan-gitea.asc] https://git.blackwall.ipv64.de/api/packages/pan/debian thueringen main" \
+  | sudo tee /etc/apt/sources.list.d/synadm-tui-thueringen.list
+sudo apt update
+sudo apt install synadm-tui-thueringen
+```
+
+Dieser Ablauf wurde mit Version 0.15 in einer isolierten APT-Umgebung geprüft: Signaturprüfung, Paketauflösung, Download, Dateirechte und Programmstart waren erfolgreich.
+
+## RPM-Status
+
+Die getrennte RPM-Quelle ist unter
+`https://git.blackwall.ipv64.de/api/packages/pan/rpm/thueringen.repo` erreichbar. Metadaten, SHA256-Prüfsumme, Paketinhalt und Programmstart von Version 0.15 wurden geprüft. Die bisher veröffentlichte RPM-Datei besitzt jedoch noch keine eingebettete Paketsignatur, obwohl die Gitea-Repository-Datei `gpgcheck=1` aktiviert. Die DNF-Installation wird deshalb erst nach Einrichtung eines dauerhaften RPM-Signaturschlüssels empfohlen; `gpgcheck` sollte nicht deaktiviert werden.
+
+## Gemeinsamen Kern aktualisieren
+
+Nach einem neuen `synadm-tui`-Release wird ausschließlich der Submodul-Pin aktualisiert:
+
+```bash
+git -C vendor/synadm-tui fetch --tags
+git -C vendor/synadm-tui checkout vNEUE_VERSION
+git add vendor/synadm-tui
+PYTHONPATH=vendor/synadm-tui python3 -m unittest discover -v
+```
+
+Anschließend werden Overlay-Version, Binärdatei und Pakete mit derselben Versionsnummer gebaut. Programmlogik wird nicht kopiert.
+
 ## Voraussetzungen
 
 - Linux x86-64 oder ARM64