diff --git a/doc/classes/TextMesh.xml b/doc/classes/TextMesh.xml
index cc11bb6d83b..a4bf9ce17e7 100644
--- a/doc/classes/TextMesh.xml
+++ b/doc/classes/TextMesh.xml
@@ -16,7 +16,8 @@
If set to something other than [constant TextServer.AUTOWRAP_OFF], the text gets wrapped inside the node's bounding rectangle. If you resize the node, it will change its height automatically to show all the text.
- Step (in pixels) used to approximate Bézier curves.
+ Step (in pixels) used to approximate Bézier curves. Lower values result in smoother curves, but is slower to generate and render. Consider adjusting this according to the font size and the typical viewing distance.
+ [b]Note:[/b] Changing this property will regenerate the mesh, which is a slow operation, especially with large font sizes and long texts.
Depths of the mesh, if set to [code]0.0[/code] only front surface, is generated, and UV layout is changed to use full texture for the front face only.
@@ -25,7 +26,8 @@
Font configuration used to display text.
- Font size of the [TextMesh]'s text.
+ Font size of the [TextMesh]'s text. This property works in tandem with [member pixel_size]. Higher values will result in a more detailed font, regardless of [member curve_step] and [member pixel_size]. Consider keeping this value below 63 (inclusive) for good performance, and adjust [member pixel_size] as needed to enlarge text.
+ [b]Note:[/b] Changing this property will regenerate the mesh, which is a slow operation, especially with large font sizes and long texts. To change the text's size in real-time efficiently, change the node's [member Node3D.scale] instead.
Controls the text's horizontal alignment. Supports left, center, right, and fill, or justify.
@@ -41,9 +43,11 @@
The text drawing offset (in pixels).
+ [b]Note:[/b] Changing this property will regenerate the mesh, which is a slow operation. To change the text's position in real-time efficiently, change the node's [member Node3D.position] instead.
- The size of one pixel's width on the text to scale it in 3D.
+ The size of one pixel's width on the text to scale it in 3D. This property works in tandem with [member font_size].
+ [b]Note:[/b] Changing this property will regenerate the mesh, which is a slow operation, especially with large font sizes and long texts. To change the text's size in real-time efficiently, change the node's [member Node3D.scale] instead.
Set BiDi algorithm override for the structured text.