From 26d8a32020bd01c64e67cf3014cc0d40e0a551e3 Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Tue, 23 Dec 2025 02:13:04 +0100
Subject: [PATCH] Document runtime alternative to Default Theme Scale project
 setting

---
 doc/classes/ProjectSettings.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/classes/ProjectSettings.xml b/doc/classes/ProjectSettings.xml
index a4840fa13c..2bd6df9015 100644
--- a/doc/classes/ProjectSettings.xml
+++ b/doc/classes/ProjectSettings.xml
@@ -1274,7 +1274,7 @@
 		</member>
 		<member name="gui/theme/default_theme_scale" type="float" setter="" getter="" default="1.0">
 			The default scale factor for [Control]s, when not overridden by a [Theme].
-			[b]Note:[/b] This property is only read when the project starts. To change the default scale at runtime, set [member ThemeDB.fallback_base_scale] instead.
+			[b]Note:[/b] This property is only read when the project starts. To change the default theme scale at runtime, set [member ThemeDB.fallback_base_scale] instead. However, to adjust the scale of all 2D elements at runtime, it's preferable to use [member Window.content_scale_factor] on the root [Window] node instead (as this also affects overridden [Theme]s). See [url=$DOCS_URL/tutorials/rendering/multiple_resolutions.html]Multiple resolutions[/url] in the documentation for details.
 		</member>
 		<member name="gui/theme/lcd_subpixel_layout" type="int" setter="" getter="" default="1">
 			LCD subpixel layout used for font anti-aliasing. See [enum TextServer.FontLCDSubpixelLayout].