From c6bf5d4c288f4a0c525d30a801cc4025c68895ae Mon Sep 17 00:00:00 2001
From: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
Date: Wed, 6 Mar 2024 12:34:19 +0100
Subject: [PATCH] [Manual] Clarify use of `delta` with `move_and_slide`

Added details to clarify that while `velocity` should not be multiplied
by `delta`, `gravity` still should.
---
 tutorials/physics/physics_introduction.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/tutorials/physics/physics_introduction.rst b/tutorials/physics/physics_introduction.rst
index e6254aa6e..b16b97754 100644
--- a/tutorials/physics/physics_introduction.rst
+++ b/tutorials/physics/physics_introduction.rst
@@ -429,7 +429,9 @@ without writing much code.
 
 .. warning:: ``move_and_slide()`` automatically includes the timestep in its
              calculation, so you should **not** multiply the velocity vector
-             by ``delta``.
+             by ``delta``. This does **not** apply to ``gravity`` as it is an
+             acceleration and is time dependent, and needs to be scaled by
+             ``delta``.
 
 For example, use the following code to make a character that can walk along
 the ground (including slopes) and jump when standing on the ground: