diff --git a/doc/08-advanced-topics.md b/doc/08-advanced-topics.md
index 0b8cf065a..d4cb3ab2d 100644
--- a/doc/08-advanced-topics.md
+++ b/doc/08-advanced-topics.md
@@ -255,6 +255,8 @@ object TimePeriod "workhours" {
}
```
+### Across midnight
+
If you want to specify a notification period across midnight,
you can define it the following way:
@@ -268,6 +270,21 @@ object Timeperiod "across-midnight" {
}
```
+Starting with v2.11 this can be shortened to using
+the first day as start with an overlapping range into
+the next day:
+
+```
+object Timeperiod "do-not-disturb" {
+ display_name = "Weekend DND"
+ ranges = {
+ "saturday" = "22:00-06:00"
+ }
+}
+```
+
+### Across several days, weeks or months
+
Below you can see another example for configuring timeperiods across several
days, weeks or months. This can be useful when taking components offline
for a distinct period of time.