From 9632a4e29e1b5f92f61e4d84071a022c91536d43 Mon Sep 17 00:00:00 2001
From: Danila <kurlykovdanila@gmail.com>
Date: Sun, 8 Jun 2025 19:43:22 +0300
Subject: [PATCH] add related methods doc

---
 crates/bevy_ecs/src/system/related_system.rs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/crates/bevy_ecs/src/system/related_system.rs b/crates/bevy_ecs/src/system/related_system.rs
index 18cdcf3276..6bc00c3d83 100644
--- a/crates/bevy_ecs/src/system/related_system.rs
+++ b/crates/bevy_ecs/src/system/related_system.rs
@@ -10,7 +10,7 @@ use bevy_ecs::{
 };
 use derive_more::derive::Display;
 
-use crate::{error::BevyError, query::QueryEntityError};
+use crate::query::QueryEntityError;
 
 /// An error that occurs when retrieving a specific Entity’s query result from [`Related`].
 #[derive(Debug, Display, Copy, Clone, PartialEq, Eq)]
@@ -53,7 +53,7 @@ pub struct Related<'w, 's, D: QueryData, F1: QueryFilter, R: RelationshipTarget,
 impl<'w, 's, D: QueryData, F1: QueryFilter, R: RelationshipTarget, F2: QueryFilter>
     Related<'w, 's, D, F1, R, F2>
 {
-    /// Read iterator
+    /// Returns an [`Iterator`] over the read-only items.
     pub fn iter(
         &'w self,
     ) -> QueryManyIter<
@@ -69,7 +69,7 @@ impl<'w, 's, D: QueryData, F1: QueryFilter, R: RelationshipTarget, F2: QueryFilt
         self.data_query
             .iter_many(self.filter_query.iter().map(|r| r.get()))
     }
-    /// Mutate iterator
+    /// Returns an [`Iterator`] over items for mutation.
     pub fn iter_mut(
         &'w mut self,
     ) -> QueryManyIter<
@@ -86,6 +86,7 @@ impl<'w, 's, D: QueryData, F1: QueryFilter, R: RelationshipTarget, F2: QueryFilt
             .iter_many_mut(self.filter_query.iter().map(|r| r.get()))
     }
 
+    /// Returns the read-only item for the given [`Entity`].
     pub fn get(
         &'w self,
         entity: Entity,
@@ -102,6 +103,7 @@ impl<'w, 's, D: QueryData, F1: QueryFilter, R: RelationshipTarget, F2: QueryFilt
         }
     }
 
+    /// Returns `true` if the given [`Entity`] matches the relative query.
     pub fn contains(&self, entity: Entity) -> bool {
         return self
             .filter_query
@@ -111,6 +113,7 @@ impl<'w, 's, D: QueryData, F1: QueryFilter, R: RelationshipTarget, F2: QueryFilt
             && self.data_query.contains(entity);
     }
 
+    /// Returns the mutating item for the given [`Entity`].
     pub fn get_mut(
         &'w mut self,
         entity: Entity,