diff --git a/src/pwm.rs b/src/pwm.rs
index eaa6a92d6..825272d51 100644
--- a/src/pwm.rs
+++ b/src/pwm.rs
@@ -114,6 +114,9 @@ pub trait PwmPin {
     fn try_enable(&mut self) -> Result<(), Self::Error>;
 
     /// Returns the current duty cycle
+    ///
+    /// While the pin is transitioning to the new duty cycle after a `try_set_duty` call, this may
+    /// return the old or the new duty cycle depending on the implementation.
     fn try_get_duty(&self) -> Result<Self::Duty, Self::Error>;
 
     /// Returns the maximum duty cycle value