Fix DocC warnings and enforce a clean documentation build in CI

Drops the no-op @metadata mergeBehavior blocks, updates the CIFP
initializer links for the progressHandler:/totalBytes: parameters added
alongside progress reporting, and removes the Creating Coordinates topic
— both initializers it listed are internal.

Adds a CI job that runs generate-documentation with --warnings-as-errors,
so a DocC warning fails the build instead of landing silently.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: RISCfuture

.github/workflows/ci.yml

@@ -41,6 +41,20 @@ jobs:
         run: swift build -v
       - name: Test
         run: swift test -v
+  docs:
+    name: Build Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: SwiftyLab/setup-swift@latest
+        with:
+          swift-version: "6.2"
+      - name: Build Documentation
+        run: |
+          swift package --allow-writing-to-directory "$RUNNER_TEMP/docs" \
+            generate-documentation --target SwiftCIFP \
+            --warnings-as-errors \
+            --output-path "$RUNNER_TEMP/docs"
   lint:
     name: Run SwiftLint
     runs-on: ubuntu-latest

Sources/SwiftCIFP/Documentation.docc/Airport.md

@@ -1,9 +1,5 @@
 # ``Airport``
 
-@Metadata {
-  @DocumentationExtension(mergeBehavior: append)
-}
-
 ## Topics
 
 ### Identification

Sources/SwiftCIFP/Documentation.docc/Airway.md

@@ -1,9 +1,5 @@
 # ``Airway``
 
-@Metadata {
-  @DocumentationExtension(mergeBehavior: append)
-}
-
 ## Topics
 
 ### Identification

Sources/SwiftCIFP/Documentation.docc/Approach.md

@@ -1,9 +1,5 @@
 # ``Approach``
 
-@Metadata {
-  @DocumentationExtension(mergeBehavior: append)
-}
-
 ## Topics
 
 ### Identification

Sources/SwiftCIFP/Documentation.docc/CIFP.md

@@ -1,16 +1,12 @@
 # ``CIFP``
 
-@Metadata {
-  @DocumentationExtension(mergeBehavior: append)
-}
-
 ## Topics
 
 ### Parsing CIFP Data
 
-- ``init(data:errorCallback:)``
-- ``init(url:errorCallback:)``
-- ``init(bytes:errorCallback:)``
+- ``init(data:progressHandler:errorCallback:)``
+- ``init(url:progressHandler:errorCallback:)``
+- ``init(bytes:totalBytes:progressHandler:errorCallback:)``
 
 ### Creating Linked Data
 

Sources/SwiftCIFP/Documentation.docc/CIFPData.md

@@ -1,9 +1,5 @@
 # ``CIFPData``
 
-@Metadata {
-  @DocumentationExtension(mergeBehavior: append)
-}
-
 ## Topics
 
 ### Creating CIFPData

Sources/SwiftCIFP/Documentation.docc/Coordinate.md

@@ -1,16 +1,7 @@
 # ``Coordinate``
 
-@Metadata {
-  @DocumentationExtension(mergeBehavior: append)
-}
-
 ## Topics
 
-### Creating Coordinates
-
-- ``init(latitudeDeg:longitudeDeg:)``
-- ``init(_:)``
-
 ### Decimal Degrees
 
 - ``latitudeDeg``

Sources/SwiftCIFP/Documentation.docc/Fix.md

@@ -1,9 +1,5 @@
 # ``Fix``
 
-@Metadata {
-  @DocumentationExtension(mergeBehavior: append)
-}
-
 ## Topics
 
 ### Cases

Sources/SwiftCIFP/Documentation.docc/ProcedureLeg.md

@@ -1,9 +1,5 @@
 # ``ProcedureLeg``
 
-@Metadata {
-  @DocumentationExtension(mergeBehavior: append)
-}
-
 ## Topics
 
 ### Identification

Sources/SwiftCIFP/Documentation.docc/Runway.md

@@ -1,9 +1,5 @@
 # ``Runway``
 
-@Metadata {
-  @DocumentationExtension(mergeBehavior: append)
-}
-
 ## Topics
 
 ### Identification