From 0e32103a99d623c3fb4482fafb3d659f3b650708 Mon Sep 17 00:00:00 2001
From: Oliver Willekens <4733178+oliverw1@users.noreply.github.com>
Date: Wed, 1 Oct 2025 10:28:13 +0200
Subject: [PATCH] Fix documentation example of fluent helpers

The REPL output now matches the instructions. Extra info has been added
to aid with the explanation as well for those who are not aware of DST.
---
 docs/docs/fluent_helpers.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/docs/docs/fluent_helpers.md b/docs/docs/fluent_helpers.md
index 2ace4910..55fcba96 100644
--- a/docs/docs/fluent_helpers.md
+++ b/docs/docs/fluent_helpers.md
@@ -45,23 +45,24 @@ converts the time in the appropriate timezone.
 ```python
 >>> import pendulum
 
->>> dt = pendulum.datetime(2013, 3, 31, 2, 30)
->>> print(dt)
+>>> dt0 = pendulum.datetime(2013, 3, 31, 2, 30)
+>>> print(dt0)
 '2013-03-31T02:30:00+00:00'
 
->>> dt = dt.set(tz='Europe/Paris')
+>>> # Paris started DST on that exact day, so 2h30 local time doesn't exist. It immediately rolls over to 3h30. 
+>>> dt = dt0.set(tz='Europe/Paris')
 >>> print(dt)
 '2013-03-31T03:30:00+02:00'
 
->>> dt = dt.in_tz('Europe/Paris')
+>>> dt = dt0.in_tz('Europe/Paris')
 >>> print(dt)
 '2013-03-31T04:30:00+02:00'
 
->>> dt = dt.set(tz='Europe/Paris').set(tz='UTC')
+>>> dt = dt0.set(tz='Europe/Paris').set(tz='UTC')
 >>> print(dt)
 '2013-03-31T03:30:00+00:00'
 
->>> dt = dt.in_tz('Europe/Paris').in_tz('UTC')
+>>> dt = dt0.in_tz('Europe/Paris').in_tz('UTC')
 >>> print(dt)
 '2013-03-31T02:30:00+00:00'
 ```