From 6fd91b0e69cd85777e1937eb53b38d531411bf42 Mon Sep 17 00:00:00 2001
From: atlas <atlas@hyperhive.local>
Date: Fri, 2 Oct 2026 20:50:15 +0200
Subject: [PATCH] docs(swarm-ui): state that every quick-link's option defaults
 to a value

argus (PR #4895): the link table didn't say an entry can exist without
the service running anywhere in the swarm. Every option in the table
defaults to a value, so a reader shouldn't take an entry's presence as
proof the service is up.
---
 docs/swarm/ui.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/swarm/ui.md b/docs/swarm/ui.md
index 63d0bf0e..fe33f3cc 100644
--- a/docs/swarm/ui.md
+++ b/docs/swarm/ui.md
@@ -117,6 +117,10 @@ same whichever host runs each service:
 | Matrix   | `services.hyperhive.swarm.matrix.gatewayHost`     |
 | Bao      | `services.hyperhive.swarm.bao.ui.domain`          |
 
+Each entry is present whenever its option has a value — every option in
+the table defaults to one, so the link appears even on a swarm that runs
+no instance of that service.
+
 `nix/host-modules/swarm-controller.nix` builds these entries. `swarm-ui.nix`
 adds one more, for this UI's own API docs. An operator can add entries
 directly. An empty list hides the button.