publish-docs.yml

name: Build and Publish Docs

on:
  workflow_dispatch:
  push:
    branches:
      - 'main'

# Kill any previous run still executing
concurrency:
  group: '${{ github.workflow }} @ ${{ github.event.pull_request.head.label || github.head_ref || github.ref }}'
  cancel-in-progress: true

jobs:
  build_docs:
    name: Build and Archive Docs
    runs-on: macos-13
    steps:
    - run: |
        sudo xcode-select -s /Applications/Xcode_15.0.app
    - name: Checkout
      uses: actions/checkout@v3

    - name: Generate docs
      run: |
        swift package \
          --allow-writing-to-directory github-pages \
          generate-documentation \
          --target Subprocess \
          --disable-indexing \
          --transform-for-static-hosting \
          --hosting-base-path Subprocess/ \
          --output-path github-pages

    - name: Upload docs archive
      uses: actions/upload-pages-artifact@main
      with:
        path: github-pages

  deploy:
    name: Deploy Docs
    needs: build_docs

    permissions:
      pages: write
      id-token: write

    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}

    runs-on: ubuntu-latest
    steps:
      - name: Deploy
        id: deployment
        uses: actions/deploy-pages@v1