From 7e85fa1b2ddf06856cdc5811a0088bc2e2ce4e9a Mon Sep 17 00:00:00 2001
From: Melih Colpan <colpanmelih@gmail.com>
Date: Fri, 9 Oct 2026 10:19:01 +0300
Subject: [PATCH] Build the Swift Package Index documentation for iOS

Swift Package Index builds documentation on macOS unless .spi.yml names a
platform. MuscleMap's UIKit integration (MuscleMapView,
HeatmapLegendUIView) is only compiled where UIKit exists, so a macOS
documentation build leaves the UIKit Integration article with ten
unresolved symbol links.

Building for iOS documents the whole API. Checked with
xcodebuild docbuild -destination generic/platform=iOS and
--warnings-as-errors: the build succeeds with no warnings, while the
macOS build used by default fails with the same flag.
---
 .spi.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.spi.yml b/.spi.yml
index 1ab3e8f..6a31ceb 100644
--- a/.spi.yml
+++ b/.spi.yml
@@ -1,4 +1,8 @@
 version: 1
 builder:
   configs:
+    # Build the documentation for iOS: the UIKit integration (MuscleMapView,
+    # HeatmapLegendUIView) only exists there, and a macOS build leaves its
+    # symbol links unresolved.
     - documentation_targets: [MuscleMap]
+      platform: ios