From ecca01f4c3a80e87069dde996f90f0d7b7951bcc Mon Sep 17 00:00:00 2001
From: "Alexander A. Klimov" <alexander.klimov@icinga.com>
Date: Mon, 2 Jan 2023 12:23:07 +0100
Subject: [PATCH] Document Notification#times being not aware of downtimes

i.e. that times.* count from HARD state change, not downtime end.
---
 doc/03-monitoring-basics.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/03-monitoring-basics.md b/doc/03-monitoring-basics.md
index d5b1577c9..672c026ff 100644
--- a/doc/03-monitoring-basics.md
+++ b/doc/03-monitoring-basics.md
@@ -1847,6 +1847,10 @@ apply Notification "mail" to Service {
 }
 ```
 
+Also note that this mechanism doesn't take downtimes etc. into account, only
+the `HARD` state change time matters. E.g. for a problem which occurred in the
+middle of a downtime from 2 PM to 4 PM `times.begin = 2h` means 5 PM, not 6 PM.
+
 ### Disable Re-notifications <a id="disable-renotification"></a>
 
 If you prefer to be notified only once, you can disable re-notifications by setting the