diff --git a/_data/rules.yml b/_data/rules.yml
index 83dfae5..0e9e3d5 100644
--- a/_data/rules.yml
+++ b/_data/rules.yml
@@ -4551,7 +4551,7 @@ groups:
                 for: 1m
                 comments: |
                   ceph_health_status: 0=HEALTH_OK, 1=HEALTH_WARN, 2=HEALTH_ERR.
-                  This rule fires on any non-OK state. Split into separate warning/critical rules by using ==1 and ==2 thresholds if needed.
+                  This rule fires on any non-OK state. Split into ==1 (warning) and ==2 (critical) if you want separate severity levels.
               - name: Ceph monitor clock skew
                 description: Ceph monitor clock skew detected. Please check ntp and hardware clock settings
                 query: "abs(ceph_monitor_clock_skew_seconds) > 0.2"
@@ -4581,7 +4581,7 @@ groups:
                 for: 5m
                 comments: |
                   Ceph internally triggers OSD_NEARFULL based on the nearfull_ratio (default 85%).
-                  ceph_health_detail can also be used for more granular OSD space alerts.
+                  ceph_health_detail exposes named health checks as individual time series.
               - name: Ceph OSD reweighted
                 description: Ceph Object Storage Daemon takes too much time to resize.
                 query: "ceph_osd_weight < 1"