Fix DocC generation simulator destination for CI compatibility#371
Merged
MikeThorntonPayPal merged 5 commits intomainfrom Feb 11, 2026
Merged
Fix DocC generation simulator destination for CI compatibility#371MikeThorntonPayPal merged 5 commits intomainfrom
MikeThorntonPayPal merged 5 commits intomainfrom
Conversation
Use generic iOS Simulator destination instead of specific device name to ensure compatibility across different CI environments. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
MikeThorntonPayPal
force-pushed
the
fix-docc-ci-simulator-destination
branch
from
8764cf1 to
122f474
Compare
Update tests workflow to use a generic iOS Simulator destination that will work on any CI runner without requiring a specific device. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
MikeThorntonPayPal
force-pushed
the
fix-docc-ci-simulator-destination
branch
from
122f474 to
38690ea
Compare
xcodebuild docbuild and xcodebuild test have different available destinations. docbuild only supports generic destinations, while test supports specific simulators. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Handle the case where gh-pages branch doesn't exist yet by properly checking if fetch succeeds before trying to checkout. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Remove custom CSS injection for hiding module icons and environment badges since the CSS selectors don't work with DocC's JavaScript- generated DOM. Documentation now displays with default DocC styling. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
sshropshire
reviewed
Feb 9, 2026
sshropshire
approved these changes
Feb 11, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Reason for changes
Fixes multiple issues preventing documentation and test workflows from running successfully on GitHub Actions CI runners.
Summary of changes
1. Documentation Generation Simulator Destination
The
ciscript was using a specific device destination (platform=iOS Simulator,name=iPhone 17) which doesn't work withxcodebuild docbuild. Documentation generation only needs a generic destination since it compiles code but doesn't execute it.Solution: Changed to
generic/platform=iOS Simulatorfor documentation builds.2. Unit Tests Workflow Simulator Destination
The tests workflow was also using
iPhone 17without specifying an OS version, causing it to fail on CI runners.Solution: Updated to
platform=iOS Simulator,name=iPhone 17,OS=26.2to explicitly specify both device and OS version.3. GitHub Pages Branch Initialization
The publish-docs workflow had faulty logic for creating the
gh-pagesbranch when it doesn't exist, causing the workflow to fail on first run.Solution: Fixed the branch creation logic to properly handle the case where
gh-pagesdoesn't exist yet.4. Non-functional CSS Customization
Removed custom CSS injection code that attempted to hide module icons and add environment badges. The CSS selectors didn't work with DocC's JavaScript-generated DOM, and the code added unnecessary complexity.
Solution: Removed all CSS customization. Documentation now uses default DocC styling, ensuring local and GitHub Pages documentation appear identical.
Checklist
Authors