doc: Small enhancements

Author: simonwalz

docs/architecture.md

@@ -49,20 +49,21 @@ sequenceDiagram
   participant GRUB
   participant Kernel
   participant Initramfs
-  participant systemd
+  participant System
   participant cuosInit as cuos-init
   participant cuosApi as cuos-api
+  participant DockerD as dockerd
   participant cuosApp as cuos-app
 
-  FW->>GRUB: Transfer control
-  GRUB->>Kernel: Load kernel + initramfs (slot @os active)
+  FW->>GRUB: Boot Host
+  GRUB->>Kernel: Load kernel + initramfs (active slot)
   Kernel->>Initramfs: Basic hardware init
-  Initramfs->>systemd: Start PID 1
+  Initramfs->>System: Start Systemd/PID 1 (active @os slot)
   systemd->>cuosInit: Apply config (hostname, network, CA, docker)
-  cuosInit->>cuosApi: Activate API layer (socket)
-  cuosApi->>cuosApp: Trigger application init
-  cuosApp->>cuosApi: Optional /api/update hook finished
-  cuosApi->>systemd: State = running
+  systemd->>cuosApi: Activate CuoS API (socket)
+  systemd->>DockerD: Start dockerd
+  systemd->>cuosApp: Trigger application init
+  cuosApp->>cuosApp: State = running
 ```
 
 ---

docs/common/cuos-api.md

@@ -135,8 +135,8 @@ cuos_api() {
 
     local return_code="$?"
     if [[ "${return_code}" != "0" ]]; then
-        echo "socat exited with return code ${return_code}."
-        return 1
+        echo "socat exited with return code ${return_code}." >&2
+        return "${return_code}"
     fi
 
     exec 3>&-
@@ -222,4 +222,4 @@ await cuosApi('patch-network', {
 4. **Network Configuration**
    - Validate network settings
    - Handle network failures
-   - Keep configurations consistent
+   - Keep configurations consistent

docs/development-guide.md

@@ -21,7 +21,7 @@ CuOS consistens of multiple services and containers.
 |---|---|
 | `cuos-init` | Initialize the system. Setup hostname, network, file system,  |
 | `cuos-api` | API for interaction with the system |
-| `cuos-app` | Ensure to start App Init Container container |
+| `cuos-app-init` | Ensure to start App Init Container container |
 | `cuos-updater` | Helper container to replace/rollback the system, kernel, initrd and boot config. Started by `cuos-api` or your application. |
 
 ## Development Variants