documentation.yml

---
name: Build and deploy documentation on merge to master

concurrency:
  group: '${{ github.workflow }} @ ${{ github.event.pull_request.head.label || github.head_ref || github.ref }}'
  cancel-in-progress: true

on:
  pull_request:
    paths:
      - 'docs/**'
      - '.github/worklows/documentation.yml'
      - 'requirements.docs.txt'
      - 'Dockerfile.docs'
      - 'mkdocs.yml'
      - 'CNAME' 
  push:
    branches:
      - master
    paths:
      - 'docs/**'
      - '.github/worklows/documentation.yml'
      - 'requirements.docs.txt'
      - 'Dockerfile.docs'
      - 'mkdocs.yml'
      - 'CNAME'

jobs:
  docs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout kapitan recursively
        uses: actions/checkout@v4
      - uses: actions/setup-python@v2
      - run: pip install --upgrade pip && pip install -r requirements.docs.txt
      - run: mkdocs build
      - name: Deploy docs
        if: github.event_name != 'pull_request' && github.ref == github.event.repository.default_branch
        uses: mhausenblas/mkdocs-deploy-gh-pages@master
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          CONFIG_FILE: ./mkdocs.yml
          REQUIREMENTS: requirements.docs.txt