fix: Make documentation generation non-blocking for releases

BrandonStalnaker · BrandonStalnaker · commit 1dc0c666df8e · 2025-08-04T14:41:54.000-04:00
diff --git a/Scripts/AppledocSettings.plist b/Scripts/AppledocSettings.plist
@@ -24,7 +24,5 @@
 	<string>mParticle</string>
 	<key>--exit-threshold</key>
 	<string>0</string>
-	<key>--warn-missing-arg</key>
-	<false/>
 </dict>
 </plist>
diff --git a/Scripts/make_artifacts.sh b/Scripts/make_artifacts.sh
@@ -49,8 +49,15 @@ function build_docs_artifact() {
     sudo sh install-appledoc.sh
     cd "$repo_dir"
 
-    appledoc --exit-threshold=0 --warn-missing-arg=NO "./Scripts/AppledocSettings.plist"
-    ditto -c -k --sequesterRsrc --keepParent "./Docs/html" "$repo_dir/generated-docs.zip"
+    # Try to generate docs, but don't fail the release if it has issues
+    if appledoc --exit-threshold=0 "./Scripts/AppledocSettings.plist"; then
+        ditto -c -k --sequesterRsrc --keepParent "./Docs/html" "$repo_dir/generated-docs.zip"
+    else
+        echo "Documentation generation failed, creating empty docs archive"
+        mkdir -p ./Docs/html
+        echo "<html><body>Documentation generation failed</body></html>" > ./Docs/html/index.html
+        ditto -c -k --sequesterRsrc --keepParent "./Docs/html" "$repo_dir/generated-docs.zip"
+    fi
 }
 
 # --- Main ---
