From 336ba216ac7a1267c1676f1ffdbb871ae5ab799a Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Mon, 18 Aug 2025 19:37:43 +0200
Subject: [PATCH] Document ClassDB not storing information on user-defined
 classes

---
 doc/classes/ClassDB.xml | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/doc/classes/ClassDB.xml b/doc/classes/ClassDB.xml
index 9c21f69b9b1..f8ec7086479 100644
--- a/doc/classes/ClassDB.xml
+++ b/doc/classes/ClassDB.xml
@@ -4,7 +4,8 @@
 		A class information repository.
 	</brief_description>
 	<description>
-		Provides access to metadata stored for every available class.
+		Provides access to metadata stored for every available engine class.
+		[b]Note:[/b] Script-defined classes with [code]class_name[/code] are not part of [ClassDB], so they will not return reflection data such as a method or property list. However, [GDExtension]-defined classes [i]are[/i] part of [ClassDB], so they will return reflection data.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -200,14 +201,15 @@
 		<method name="get_class_list" qualifiers="const">
 			<return type="PackedStringArray" />
 			<description>
-				Returns the names of all the classes available.
+				Returns the names of all engine classes available.
+				[b]Note:[/b] Script-defined classes with [code]class_name[/code] are not included in this list. Use [method ProjectSettings.get_global_class_list] to get a list of script-defined classes instead.
 			</description>
 		</method>
 		<method name="get_inheriters_from_class" qualifiers="const">
 			<return type="PackedStringArray" />
 			<param index="0" name="class" type="StringName" />
 			<description>
-				Returns the names of all the classes that directly or indirectly inherit from [param class].
+				Returns the names of all engine classes that directly or indirectly inherit from [param class].
 			</description>
 		</method>
 		<method name="get_parent_class" qualifiers="const">