publish-docs.yaml

name: Publish Docs

on:
  push:
    branches: [ main ]
  
permissions:
  contents: write

concurrency:
  group: publish-docs-${{github.ref_name}}
  cancel-in-progress: false

jobs:

  build:
    
    runs-on: macos-12

    steps:
    - uses: actions/checkout@v3

    - name: Select Xcode
      run: sudo xcode-select -s /Applications/Xcode_14.1.app/Contents/Developer

    - name: Build Docs
      run: make generate-docs SUBDIR=${{ github.ref_name }}

    - name: Archive Docs
      run: tar -czf docs.tar.gz -C .build docs

    - name: Upload Docs Archive
      uses: actions/upload-artifact@v3
      with:
        name: docs-${{ github.ref_name }}
        path: docs.tar.gz

  deploy:

    runs-on: ubuntu-latest
    needs: [ build ]

    steps:
    - uses: actions/checkout@v3

    - name: Download Docs Archive
      uses: actions/download-artifact@v3
      with:
        name: docs-${{ github.ref_name }}
        path: '.'

    - name: Unarchive Docs
      run: tar -xvf docs.tar.gz

    - name: Deploy Docs
      uses: JamesIves/github-pages-deploy-action@v4
      with:
        folder: docs
        clean: false