From b02d25605d9987090b08bdd15bd975c14a575035 Mon Sep 17 00:00:00 2001
From: AttackButton <rtfranco@gmail.com>
Date: Sat, 5 Aug 2023 19:42:43 -0300
Subject: [PATCH] Clarify SceneTree.current_scene functionality

---
 doc/classes/SceneTree.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/classes/SceneTree.xml b/doc/classes/SceneTree.xml
index c0d98ef921d..7aed63a2fc6 100644
--- a/doc/classes/SceneTree.xml
+++ b/doc/classes/SceneTree.xml
@@ -225,7 +225,8 @@
 			For mobile platforms, see [member quit_on_go_back].
 		</member>
 		<member name="current_scene" type="Node" setter="set_current_scene" getter="get_current_scene">
-			The current scene.
+			Returns the root node of the currently running scene, regardless of its structure.
+			[b]Warning:[/b] Setting this directly might not work as expected, and will [i]not[/i] add or remove any nodes from the tree, consider using [method change_scene_to_file] or [method change_scene_to_packed] instead.
 		</member>
 		<member name="debug_collisions_hint" type="bool" setter="set_debug_collisions_hint" getter="is_debugging_collisions_hint" default="false">
 			If [code]true[/code], collision shapes will be visible when running the game from the editor for debugging purposes.