Reword

crates/bevy_transform/src/components/transform.rs

@@ -120,7 +120,8 @@ impl Transform {
     /// local `Z` direction is toward `target` and its unit vector in the local `Y` direction
     /// is toward `up`.
     ///
-    /// Produces a broken rotation if the resulting forward direction is parralel with `up`.
+    /// It is not possible to construct a rotation when the resulting forward direction is parallel with `up`.
+    /// This will result in the [`Transform`] having a broken rotation.
     #[inline]
     #[must_use]
     pub fn looking_at(mut self, target: Vec3, up: Vec3) -> Self {
@@ -318,7 +319,8 @@ impl Transform {
     /// Rotates this [`Transform`] so that its local negative `Z` direction is toward
     /// `target` and its local `Y` direction is toward `up`.
     ///
-    /// Produces a broken rotation if the resulting forward direction is parralel with `up`.
+    /// It is not possible to construct a rotation when the resulting forward direction is parallel with `up`.
+    /// This will result in the [`Transform`] having a broken rotation.
     #[inline]
     pub fn look_at(&mut self, target: Vec3, up: Vec3) {
         let forward = Vec3::normalize(self.translation - target);