Fixing some doc comments

crates/bevy_animation/src/lib.rs

@@ -178,8 +178,8 @@ pub struct AnimationPlayer {
 }
 
 impl AnimationPlayer {
-    /// Start playing an animation, resetting state of the player
-    /// This will use a linear blending between the previous and the new animation to make a smooth transition
+    /// Start playing an animation, resetting state of the player.
+    /// This will use a linear blending between the previous and the new animation to make a smooth transition.
     pub fn start(&mut self, handle: Handle<AnimationClip>) -> &mut Self {
         self.animation = PlayingAnimation {
             animation_clip: handle,
@@ -193,8 +193,8 @@ impl AnimationPlayer {
         self
     }
 
-    /// Start playing an animation, resetting state of the player
-    /// This will use a linear blending between the previous and the new animation to make a smooth transition
+    /// Start playing an animation, resetting state of the player.
+    /// This will use a linear blending between the previous and the new animation to make a smooth transition.
     pub fn start_with_transition(
         &mut self,
         handle: Handle<AnimationClip>,
@@ -208,7 +208,7 @@ impl AnimationPlayer {
 
         // Add the current transition. If other transitions are still ongoing,
         // this will keep those transitions running and cause a transition between
-        // the output of that previous transition to the new animation.
+        // the output of that previous transition to the new animation
         self.transitions.push(AnimationTransition {
             current_weight: 1.0,
             weight_decline_per_sec: 1.0 / transition_duration.as_secs_f32(),

crates/bevy_asset/src/assets.rs

@@ -146,7 +146,7 @@ impl<T: Asset> Assets<T> {
     /// Get mutable access to the asset for the given handle.
     ///
     /// This is the main method for mutably accessing asset data from an [Assets] collection. If you
-    /// do not need mutable access to the asset, you may also use [get](Assets::get).
+    /// do not need mutable access to the asset, you may also use [`get`](Assets::get).
     pub fn get_mut(&mut self, handle: &Handle<T>) -> Option<&mut T> {
         let id: HandleId = handle.into();
         self.events.send(AssetEvent::Modified {

crates/bevy_audio/src/audio.rs

@@ -53,7 +53,7 @@ impl VolumeLevel {
     }
 }
 
-/// How should Bevy manage the sound playback?
+/// Playback mode controls
 #[derive(Debug, Clone, Copy)]
 pub enum PlaybackMode {
     /// Play the sound once. Do nothing when it ends.

crates/bevy_audio/src/audio_source.rs

@@ -68,7 +68,7 @@ impl AssetLoader for AudioLoader {
 /// in order to be registered.
 /// Types that implement this trait usually contain raw sound data that can be converted into an iterator of samples.
 /// This trait is implemented for [`AudioSource`].
-/// Check the example `audio/decodable` for how to implement this trait on a custom type.
+/// Check the example [`decodable`](https://github.com/bevyengine/bevy/blob/latest/examples/audio/decodable.rs) for how to implement this trait on a custom type.
 pub trait Decodable: Send + Sync + 'static {
     /// The type of the audio samples.
     /// Usually a [`u16`], [`i16`] or [`f32`], as those implement [`rodio::Sample`].

crates/bevy_transform/src/commands.rs

@@ -1,12 +1,9 @@
-//! Extension to [`EntityCommands`] to modify [`bevy_hierarchy`] hierarchies
+//! Extension to [`EntityCommands`] to modify `bevy_hierarchy` hierarchies
 //! while preserving [`GlobalTransform`].
 
 use bevy_ecs::{prelude::Entity, system::Command, system::EntityCommands, world::World};
 use bevy_hierarchy::{AddChild, RemoveParent};
 
-#[cfg(doc)]
-use bevy_hierarchy::BuildChildren;
-
 use crate::{GlobalTransform, Transform};
 
 /// Command similar to [`AddChild`], but updating the child transform to keep
@@ -69,7 +66,7 @@ pub trait BuildChildrenTransformExt {
     /// Change this entity's parent while preserving this entity's [`GlobalTransform`]
     /// by updating its [`Transform`].
     ///
-    /// See [`BuildChildren::set_parent`] for a method that doesn't update the
+    /// See [`BuildChildren::set_parent`](bevy_hierarchy::child_builder::BuildChildren::set_parent) for a method that doesn't update the
     /// [`Transform`].
     ///
     /// Note that both the hierarchy and transform updates will only execute
@@ -80,7 +77,7 @@ pub trait BuildChildrenTransformExt {
     /// Make this entity parentless while preserving this entity's [`GlobalTransform`]
     /// by updating its [`Transform`] to be equal to its current [`GlobalTransform`].
     ///
-    /// See [`BuildChildren::remove_parent`] for a method that doesn't update the
+    /// See [`BuildChildren::remove_parent`](bevy_hierarchy::child_builder::BuildChildren::remove_parent) for a method that doesn't update the
     /// [`Transform`].
     ///
     /// Note that both the hierarchy and transform updates will only execute

crates/bevy_winit/src/lib.rs

@@ -63,10 +63,10 @@ use crate::web_resize::{CanvasParentResizeEventChannel, CanvasParentResizePlugin
 #[cfg(target_os = "android")]
 pub static ANDROID_APP: std::sync::OnceLock<AndroidApp> = std::sync::OnceLock::new();
 
-/// A [`Plugin`] that uses [`winit`] to create and manage windows, and receive window and input
+/// A [`Plugin`] that uses `winit` to create and manage windows, and receive window and input
 /// events.
 ///
-/// This plugin will add systems and resources that sync with the [`winit`] backend and also
+/// This plugin will add systems and resources that sync with the `winit` backend and also
 /// replace the exising [`App`] runner with one that constructs an [event loop](EventLoop) to
 /// receive window and input events from the OS.
 #[derive(Default)]

crates/bevy_winit/src/winit_windows.rs

@@ -21,7 +21,7 @@ use crate::{
     converters::{convert_enabled_buttons, convert_window_level, convert_window_theme},
 };
 
-/// A resource mapping window entities to their [`winit`]-backend [`Window`](winit::window::Window)
+/// A resource mapping window entities to their `winit`-backend [`Window`](winit::window::Window)
 /// states.
 #[derive(Debug, Default)]
 pub struct WinitWindows {