generate-documentation.yml

name: Generate Documentation

on:
  push:
    tags:
      - '0.0.*'
  pull_request:
    paths:
      - .github/workflows/generate-documentation.yml
      - scripts/generatedocc.sh
      - scripts/generatedoccindex.sh
    # release:
      # types: [published]

permissions:
  id-token: write

jobs:
  generate-docs:
    strategy:
      matrix:
        # Use strategy to split up the work into 32 jobs
        # job: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31]
        job: [0, 1, 2, 3]
    runs-on: ubuntu-latest
    container: swift:5.9-jammy
    env:
      IGNORE: xxx
    steps:
      - name: Checkout Sources
        uses: actions/checkout@v2
      - name: Configure AWS Credentials
        uses: aws-actions/configure-aws-credentials@v1
        with:
          role-to-assume: ${{ secrets.CD_API_REFS_PUBLISH_ROLE_ARN }}
          aws-region: us-east-1
      - name: Display user
        run: aws sts get-caller-identity
      - name: Extract version from GITHUB_REF
        id: update-version
        run: |
          if [[ $GITHUB_REF == refs/tags/* ]]; then
            echo "Tagged release"
            # get last part of GITHUB_REF separated by /
            VERSION=$(echo $GITHUB_REF | tr '/' '\n' | tail -1)
            echo "Version: $VERSION"
            echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
          else
            echo "Error: runs on a tag only"
            exit(1)
          fi
      - name: Generate docs
        run: ./scripts/generatedocc.sh $VERSION ${{ matrix.job }} ${{ strategy.job-total }} ${{ env.IGNORE }}