Fix all DocC documentation warnings

Correct mismatched parameter names, replace unresolvable symbol
links with code formatting, and add missing parameter documentation.

Author: tomasf

Sources/Cadova/Abstract Layer/3D/Mesh.swift

@@ -143,7 +143,10 @@ public extension Mesh {
     /// any variable inputs that affect the resulting geometry so Cadova can safely reuse cached
     /// results without returning stale meshes.
     ///
-    /// - Parameter faces: A sequence of polygonal faces, where each face is a sequence of `Vector3D` points.
+    /// - Parameters:
+    ///   - faces: A sequence of polygonal faces, where each face is a sequence of `Vector3D` points.
+    ///   - name: A name used for caching the mesh.
+    ///   - cacheParameters: Additional hashable parameters that uniquely identify this mesh for caching purposes.
     ///
     /// - Important: All faces must contain at least 3 points. The combined set of faces must define a closed and manifold solid.
     init<Face: Sequence<Vector3D>, FaceList: Sequence<Face>>(

Sources/Cadova/Abstract Layer/Geometry/References/Anchors+Public.swift

@@ -8,8 +8,8 @@ import Foundation
 /// at specific locations.
 ///
 /// You create an anchor once (optionally with a human-readable label for debugging) and then define
-/// it on geometry using ``Geometry3D/definingAnchor(_:at:offset:pointing:rotated:)``. Later, you can
-/// use ``Geometry3D/anchored(to:)`` to place other geometry at the recorded transforms.
+/// it on geometry using `definingAnchor(_:at:offset:pointing:rotated:)`. Later, you can
+/// use `anchored(to:)` to place other geometry at the recorded transforms.
 ///
 /// - Multiple definitions:
 ///   - An anchor can be defined multiple times across a geometry tree. Each definition records a

Sources/Cadova/Abstract Layer/Geometry/ResultElement/ResultElement.swift

@@ -30,7 +30,7 @@ public protocol ResultElement: Sendable {
     /// is present. Implementations should define a stable, deterministic merge policy
     /// (such as last-wins, union, intersection, or accumulation) appropriate to the element’s meaning.
     ///
-    /// - Parameter elements: The instances to be combined.
+    /// - Parameter combining: The instances to be combined.
     init(combining: [Self])
 }
 

Sources/Cadova/Abstract Layer/Operations/Follow3D.swift

@@ -34,7 +34,7 @@ public extension Geometry3D {
     /// - Parameter path: A 2D parametric curve interpreted in the XY plane that the geometry should follow.
     /// - Returns: A warped version of the geometry that follows the 2D path.
     ///
-    /// - SeeAlso: ``following(path:pointing:toward:)``, ``Geometry2D/swept(along:pointing:toward:)``, ``Geometry3D/deformed(by:)``
+    /// - SeeAlso: ``following(path:pointing:toward:)``, `swept(along:pointing:toward:)`, `deformed(by:)`
     func following<Path: ParametricCurve<Vector2D>>(path: Path) -> any Geometry3D {
         rotated(y: -90°)
             .following(path: path.curve3D, pointing: .positiveX, toward: .direction(.negativeZ))

Sources/Cadova/Abstract Layer/Operations/Loft/Loft.swift

@@ -118,7 +118,7 @@ public struct Loft: Geometry {
     /// A single cross-section in a lofted shape.
     ///
     /// Each layer defines a 2D shape at a specific Z height. Layers are created using the
-    /// ``layer(z:interpolation:shape:)`` function within a ``Loft`` builder.
+    /// `layer(z:interpolation:shape:)` function within a ``Loft`` builder.
     ///
     public struct Layer: Sendable {
         internal let z: Double

Sources/Cadova/Abstract Layer/Operations/Measure.swift

@@ -64,7 +64,7 @@ public extension Geometry {
     ///            only the main geometry, `.solidParts` (default) to include solid/printable parts, or
     ///            `.allParts` to include every part (solid, context, and visual).
     ///   - builder: A closure that receives the geometry and its bounding box, and returns a new geometry.
-    ///   - empty: A closure that provides fallback geometry when the original geometry is empty. Defaults to `Empty()`.
+    ///   - emptyBuilder: A closure that provides fallback geometry when the original geometry is empty. Defaults to `Empty()`.
     /// - Returns: A modified geometry based on the bounding box, or the result of `empty` if no bounds exist.
     ///
     func measuringBounds<Output: Dimensionality>(

Sources/Cadova/Abstract Layer/Operations/Transformations/RotateAround.swift

@@ -11,8 +11,9 @@ public extension Geometry2D {
     ///
     /// - Parameters:
     ///   - angle: The angle to rotate the geometry. Defaults to `0°`.
-    ///   - pivot: A list of alignment options that specify the pivot point for the rotation. For example, `.center`
+    ///   - pivot: An alignment option that specifies the pivot point for the rotation. For example, `.center`
     ///     can be used to rotate the geometry around its center, while `.top` can rotate it around the top boundary.
+    ///   - more: Additional alignment options for the pivot point.
     ///
     /// - Returns: A new geometry that is the result of applying the specified rotation and pivot adjustments.
     ///
@@ -22,7 +23,7 @@ public extension Geometry2D {
     ///     .rotated(45°, around: .center)
     /// ```
     /// This example rotates the square 45 degrees around its center.
-    /// 
+    ///
     func rotated(
         _ angle: Angle = 0°,
         around pivot: GeometryAlignment2D,
@@ -50,8 +51,9 @@ public extension Geometry3D {
     ///   - x: The angle to rotate around the X-axis. Defaults to `0°`.
     ///   - y: The angle to rotate around the Y-axis. Defaults to `0°`.
     ///   - z: The angle to rotate around the Z-axis. Defaults to `0°`.
-    ///   - pivot: A list of alignment options that specify the pivot point for the rotation. For example, `.center`
+    ///   - pivot: An alignment option that specifies the pivot point for the rotation. For example, `.center`
     ///     can be used to rotate the geometry around its center, while `.top` can rotate it around the top boundary.
+    ///   - more: Additional alignment options for the pivot point.
     ///
     /// - Returns: A new geometry that is the result of applying the specified rotation and pivot adjustments.
     ///
@@ -61,7 +63,7 @@ public extension Geometry3D {
     ///     .rotated(x: 90°, around: .center)
     /// ```
     /// This example rotates the box 90 degrees around its center.
-    /// 
+    ///
     func rotated(
         x: Angle = 0°,
         y: Angle = 0°,

Sources/Cadova/Abstract Layer/Visualization/BoundingBoxVisualization.swift

@@ -19,7 +19,7 @@ public extension Geometry3D {
     /// Overlays the geometry's bounding box as a thin 3D frame for debugging.
     ///
     /// This is useful for visualizing the region affected by range-based spatial APIs
-    /// like ``within(x:y:z:)`` or ``EdgeCriteria/within(x:y:z:)``.
+    /// like `within(x:y:z:)` or `EdgeCriteria.within(x:y:z:)`.
     ///
     /// ```swift
     /// // Visualize the entire bounding box

Sources/Cadova/Concrete Layer/Build/Group/Group.swift

@@ -2,14 +2,14 @@ import Foundation
 
 /// A container for organizing models into logical groups with optional subdirectories.
 ///
-/// Use `Group` to organize related models within a ``Project``. Groups can specify shared
+/// Use `Group` to organize related models within a `Project`. Groups can specify shared
 /// `ModelOptions` and `EnvironmentValues` that apply to all contained models, and can
 /// optionally define a subdirectory name for file organization.
 ///
 /// Groups can be nested, allowing for hierarchical organization of models.
 ///
 /// > Note: Unlike ``Model``, which can be used standalone, `Group` must be used within
-/// > a ``Project`` or another `Group`.
+/// > a `Project` or another `Group`.
 ///
 /// In addition to `Model` and nested `Group` entries, the group's result builder also accepts:
 /// - `Metadata(...)`: Attaches metadata that is combined into shared `ModelOptions`

Sources/Cadova/Concrete Layer/Build/Model/Model.swift

@@ -11,7 +11,7 @@ import Foundation
 /// }
 /// ```
 ///
-/// Models can also be grouped within a ``Project`` to share environment settings and metadata
+/// Models can also be grouped within a `Project` to share environment settings and metadata
 /// across multiple output files.
 ///
 /// For fine-grained control of file output, see ``ModelFileGenerator``.