diff --git a/docs/reference/glossary.md b/docs/reference/glossary.md
index af640a62..b177047e 100644
--- a/docs/reference/glossary.md
+++ b/docs/reference/glossary.md
@@ -86,7 +86,7 @@ Alertmanager
     * [the Alertmanager documentation](https://prometheus.io/docs/alerting/latest/alertmanager/)
 
     Related topic(s):
-    * Observability and {term}`Prometheus`
+    * {ref}`how-to-observability`
 
 ALUA
 Asymmetric Logical Unit Access
@@ -1708,6 +1708,14 @@ NVIDIA NVLink Switch
 
 :::{glossary}
 
+Observability
+    Observability is the practice of understanding what is happening inside a complex software system by analysing the data it emits (metrics, logs, traces, events).
+
+    See also:
+    *[OpenTelemetry](https://opentelemetry.io) 
+    
+
+    
 OCF
 Open Cluster Framework
     *Work in Progress*
@@ -1917,7 +1925,12 @@ preseed
     *Work in Progress*
 
 Prometheus
-    *Work in Progress*
+    Prometheus is an open‑source monitoring and alerting toolkit used to collect and query metrics from applications and infrastructure.
+
+    See also:
+    * ["Prometheus"](https://en.wikipedia.org/wiki/Prometheus_(software))
+    * ["Prometheus official site"](https://prometheus.io/)
+
 
 proxy
     *Work in Progress*
@@ -1942,6 +1955,7 @@ PXE Linux Loader
 
 
 (terms_Q)=
+
 ## Q
 
 :::{glossary}