Fix DocC links and enforce documentation warnings in CI

The catalog still named the pre-progress-handling initializers, so none
of the six links resolved. A new CI job builds the documentation with
--warnings-as-errors, so a broken link fails the build instead of
shipping quietly.

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 SwiftDOF --output-path "$RUNNER_TEMP/docs" \
+           --warnings-as-errors
   lint:
     name: Run SwiftLint
     runs-on: ubuntu-latest

Sources/SwiftDOF/Documentation.docc/DOF.md

@@ -4,12 +4,12 @@
 
 ### Parsing a DOF
 
-- ``init(data:errorCallback:)``
-- ``init(url:errorCallback:)``
-- ``init(bytes:errorCallback:)``
-- ``from(filePath:errorCallback:)``
-- ``from(data:errorCallback:)``
-- ``from(url:errorCallback:)``
+- ``init(data:progressHandler:errorCallback:)``
+- ``init(url:progressHandler:errorCallback:)``
+- ``init(bytes:totalBytes:progressHandler:errorCallback:)``
+- ``from(filePath:progressHandler:errorCallback:)``
+- ``from(data:progressHandler:errorCallback:)``
+- ``from(url:progressHandler:errorCallback:)``
 
 ### Properties
 

Sources/SwiftDOF/Documentation.docc/Documentation.md

@@ -23,7 +23,7 @@ Key features:
 SwiftDOF uses **strict parsing** - it throws errors for any malformed or invalid
 data rather than silently accepting it. This ensures data integrity and makes
 debugging easier. All parsing errors are reported via either thrown exceptions or
-the ``DOF/init(data:errorCallback:)`` callback parameter.
+the ``DOF/init(data:progressHandler:errorCallback:)`` callback parameter.
 
 ## Topics