Added example of entity sorting by components

Author: YohDeadfall

crates/bevy_ecs/src/core/world.rs

@@ -236,12 +236,14 @@ impl World {
     /// let a = world.spawn((123, true, "abc"));
     /// let b = world.spawn((456, false));
     /// let c = world.spawn((42, "def"));
-    /// let entities = world.query::<(Entity, &i32, &bool)>()
+    /// let mut entities = world.query::<(Entity, &i32, &bool)>()
     ///     .map(|(e, &i, &b)| (e, i, b)) // Copy out of the world
     ///     .collect::<Vec<_>>();
+    /// // Sort by `i32` component in reverse and by `bool` then
+    /// entities.sort_by(|x, y| x.1.cmp(&y.1).reverse().then(x.2.cmp(&y.2)))
     /// assert_eq!(entities.len(), 2);
-    /// assert!(entities.contains(&(a, 123, true)));
-    /// assert!(entities.contains(&(b, 456, false)));
+    /// assert!(entities[0] == (b, 456, false));
+    /// assert!(entities[1] == (a, 123, true));
     /// ```
     #[inline]
     pub fn query<Q: WorldQuery>(&self) -> QueryIter<'_, Q, ()>