From f354502188b287accd389f738a1ad5c6c5d5777b Mon Sep 17 00:00:00 2001
From: newclarityex <69740123+newclarityex@users.noreply.github.com>
Date: Mon, 24 Nov 2025 21:17:20 +0400
Subject: [PATCH] Document return behavior for child "spawning" commands.

---
 crates/bevy_ecs/src/hierarchy.rs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/crates/bevy_ecs/src/hierarchy.rs b/crates/bevy_ecs/src/hierarchy.rs
index bde9526d72136..2280ccb72b1e1 100644
--- a/crates/bevy_ecs/src/hierarchy.rs
+++ b/crates/bevy_ecs/src/hierarchy.rs
@@ -368,6 +368,7 @@ impl<'w> EntityWorldMut<'w> {
     }
 
     /// Spawns the passed bundle and adds it to this entity as a child.
+    /// Returns &mut [`EntityWorldMut`] for parent.
     ///
     /// For efficient spawning of multiple children, use [`with_children`].
     ///
@@ -480,6 +481,7 @@ impl<'a> EntityCommands<'a> {
     }
 
     /// Spawns the passed bundle and adds it to this entity as a child.
+    /// Returns &mut [`EntityCommands`] for parent.
     ///
     /// For efficient spawning of multiple children, use [`with_children`].
     ///