GitHub Actions and DocC Static Web Site

GitHub offers and options to public Static Web Site on in their GitHub Pages environment. The site can either be uploaded to your GitHub Project into the directory doc and the GitHub will upload it to a private or public github.io domain and be accessed there or even have configured a custom domain. The second option about this Static Web Site feature is created dinamically through GitHub Actions.

I have wrote a YML GitHub Actions file that build a DocC Swift Documentation out of a Swift SPM
projects and publish it in GitHub Pages. The GitHub Project must to have set a GitHub Action -> Secret called REMOTE_TOKEN which will contain and access token to the GitHub Project and a GitHub Action -> Variable called FRAMEWORK_TARGET which contains the Swift SPM target.
Check docc-to-pages.yml for the full source file.

The main tasks performed in the file are:

• Build the DocC Static Web Site
• Compress the Static Web Site
• Deploy the Static Web Site into the GitHub Pages domain