Improve Rotate docs (#1031)

* Improve Rotate docs

* Fix docs

Author: juliohm

docs/src/transforms.md

@@ -30,11 +30,9 @@ Rotate
 ```
 
 ```@example transforms
-using Rotations: Angle2d
-
 grid = CartesianGrid(10, 10)
 
-mesh = grid |> Rotate(Angle2d(π/4))
+mesh = grid |> Rotate(π/4)
 
 fig = Mke.Figure(size = (800, 400))
 viz(fig[1,1], grid)
@@ -83,6 +81,8 @@ Affine
 ```
 
 ```@example transforms
+using Rotations: Angle2d
+
 grid = CartesianGrid(10, 10)
 
 mesh = grid |> Affine(Angle2d(π/4), [10., 20.])

src/transforms/rotate.jl

@@ -3,52 +3,39 @@
 # ------------------------------------------------------------------
 
 """
-    Rotate(rot)
+    Rotate(R)
 
-Rotate geometry or mesh with rotation `rot`
-from Rotations.jl.
+Rotate geometry or domain with rotation `R` from Rotations.jl.
 
-## Examples
-
-```julia
-Rotate(one(RotXYZ{Float64}))  # Generate identity rotation
-Rotate(AngleAxis(0.2, 1.0, 0.0, 0.0))  # Rotate 0.2 radians around X-axis
-Rotate(rand(QuatRotation{Float64}))  # Generate random rotation
-```
-"""
-struct Rotate{R<:Rotation} <: CoordinateTransform
-  rot::R
-end
-
-"""
     Rotate(u, v)
 
 Rotation mapping the axis directed by `u` to the axis directed by `v`. 
 More precisely, it maps the plane passing through the origin with normal 
 vector `u` to the plane passing through the origin with normal vector `v`.
 
+    Rotate(θ)
+
+Rotate the 2D geometry or domain by angle `θ`, in radians, using the
+`Angle2d` rotation.
+
 ## Examples
 
 ```julia
-Rotate(Vec(1, 0, 0), Vec(1, 1, 1))
+Rotate(one(RotXYZ{Float64})) # identity rotation
+Rotate(AngleAxis(0.2, 1.0, 0.0, 0.0)) # rotate 0.2 radians around X axis
+Rotate(rand(QuatRotation{Float64})) # random rotation
+Rotate(Vec(1, 0, 0), Vec(1, 1, 1)) # rotation from (1, 0, 0) to (1, 1, 1)
+Rotate(π / 2) # 2D rotation with angle in radians
 ```
 """
+struct Rotate{R<:Rotation} <: CoordinateTransform
+  rot::R
+end
+
 Rotate(u::Vec, v::Vec) = Rotate(urotbetween(u, v))
 
 Rotate(u::Tuple, v::Tuple) = Rotate(Vec(u), Vec(v))
 
-"""
-    Rotate(θ)
-
-Rotate the 2D geometry or mesh by angle `θ`, in radians,
-using the `Angle2d` rotation.
-
-## Examples
-
-```julia
-Rotate(π / 2)
-```
-"""
 Rotate(θ) = Rotate(Angle2d(θ))
 
 parameters(t::Rotate) = (; rot=t.rot)