diff --git a/crates/bevy_ecs/src/system/query.rs b/crates/bevy_ecs/src/system/query.rs
index 5553e475ed9d6..110f6b0b339f9 100644
--- a/crates/bevy_ecs/src/system/query.rs
+++ b/crates/bevy_ecs/src/system/query.rs
@@ -1119,7 +1119,8 @@ impl<'w, 's, D: QueryData, F: QueryFilter> Query<'w, 's, D, F> {
     /// # struct Player;
     /// # #[derive(Component)]
     /// # struct Position(f32, f32);
-    /// fn player_system(query: Single<&Position, With<Player>>) {
+    /// fn player_system(query: Query<&Position, With<Player>>) {
+    ///     let player_position = query.single();
     ///     // do something with player_position
     /// }
     /// # bevy_ecs::system::assert_is_system(player_system);
@@ -1195,7 +1196,8 @@ impl<'w, 's, D: QueryData, F: QueryFilter> Query<'w, 's, D, F> {
     /// # #[derive(Component)]
     /// # struct Health(u32);
     /// #
-    /// fn regenerate_player_health_system(mut query: Single<&mut Health, With<Player>>) {
+    /// fn regenerate_player_health_system(mut query: Query<&mut Health, With<Player>>) {
+    ///     let mut health = query.single_mut();
     ///     health.0 += 1;
     /// }
     /// # bevy_ecs::system::assert_is_system(regenerate_player_health_system);