Swift DocC publishing and deployment

This skill provides step-by-step instructions, CLI flag references, and CI/CD pipelines for compiling Swift DocC documentation into static websites, previewing them locally, and hosting them on GitHub Pages or static web servers.

References

• references/hosting-and-ci-cd.md: Consult when configuring CLI compilation flags, setting --hosting-base-path for GitHub Pages, previewing static sites locally, configuring GitHub Actions workflows, or troubleshooting 404/SPA routing issues.

1. Compilation methods overview

DocC documentation can be compiled using either the Swift Package Manager DocC Plugin (swift-docc-plugin) or direct invocations of xcrun docc / docc.