diff --git a/packages/integrations/src/unifi-site-manager/unifi-site-manager-types.ts b/packages/integrations/src/unifi-site-manager/unifi-site-manager-types.ts
index 589e30877..e4728ed1f 100644
--- a/packages/integrations/src/unifi-site-manager/unifi-site-manager-types.ts
+++ b/packages/integrations/src/unifi-site-manager/unifi-site-manager-types.ts
@@ -135,7 +135,11 @@ export interface UnifiSiteManagerSite {
   summary: UnifiSiteHealthSummary;
   latencyMs: number | null;
   packetLossPct: number | null;
-  /** `null` si le site n'appartient à aucune configuration SD-WAN. */
+  /**
+   * `null` couvre DEUX cas que ce contrat ne distingue pas : le site n'appartient
+   * à aucune configuration SD-WAN, ou l'appel de statut a échoué. Ne pas en
+   * déduire l'un des deux à l'affichage — le tiret dit « on ne sait pas ».
+   */
   sdWan: UnifiSiteSdWanStatus | null;
 }