diff --git a/doc/classes/ShapeCast2D.xml b/doc/classes/ShapeCast2D.xml
index a04ffe3881c..d71c9ce13a4 100644
--- a/doc/classes/ShapeCast2D.xml
+++ b/doc/classes/ShapeCast2D.xml
@@ -34,7 +34,7 @@
- Updates the collision information for the shape. Use this method to update the collision information immediately instead of waiting for the next [code]_physics_process[/code] call, for example if the shape or its parent has changed state.
+ Updates the collision information for the shape immediately, without waiting for the next [code]_physics_process[/code] call. Use this method, for example, when the shape or its parent has changed state.
[b]Note:[/b] [code]enabled == true[/code] is not required for this to work.
@@ -130,10 +130,10 @@
- If [code]true[/code], collision with [Area2D]s will be reported.
+ If [code]true[/code], collisions with [Area2D]s will be reported.
- If [code]true[/code], collision with [PhysicsBody2D]s will be reported.
+ If [code]true[/code], collisions with [PhysicsBody2D]s will be reported.
The shape's collision mask. Only objects in at least one collision layer enabled in the mask will be detected.
diff --git a/doc/classes/ShapeCast3D.xml b/doc/classes/ShapeCast3D.xml
index ce729440986..e189628f4c5 100644
--- a/doc/classes/ShapeCast3D.xml
+++ b/doc/classes/ShapeCast3D.xml
@@ -34,7 +34,7 @@
- Updates the collision information for the shape. Use this method to update the collision information immediately instead of waiting for the next [code]_physics_process[/code] call, for example if the shape or its parent has changed state.
+ Updates the collision information for the shape immediately, without waiting for the next [code]_physics_process[/code] call. Use this method, for example, when the shape or its parent has changed state.
[b]Note:[/b] [code]enabled == true[/code] is not required for this to work.
@@ -137,10 +137,10 @@
- If [code]true[/code], collision with [Area3D]s will be reported.
+ If [code]true[/code], collisions with [Area3D]s will be reported.
- If [code]true[/code], collision with [PhysicsBody3D]s will be reported.
+ If [code]true[/code], collisions with [PhysicsBody3D]s will be reported.
The shape's collision mask. Only objects in at least one collision layer enabled in the mask will be detected. See [url=$DOCS_URL/tutorials/physics/physics_introduction.html#collision-layers-and-masks]Collision layers and masks[/url] in the documentation for more information.