docs.yml

name: 'Linuxfabrik: Deploy Documentation'

on:
  push:
    branches:
      - 'main'

permissions:
  contents: 'read'
  pages: 'write'
  id-token: 'write'

concurrency:
  group: 'pages'
  cancel-in-progress: true

jobs:
  build:
    runs-on: 'ubuntu-latest'
    steps:
      - name: 'Checkout repository'
        uses: 'actions/checkout@v6'

      - name: 'Set up Python'
        uses: 'actions/setup-python@v6'
        with:
          python-version: '3.12'

      - name: 'Install dependencies'
        run: 'pip install mkdocs mkdocs-material'

      - name: 'Generate docs structure'
        run: 'python3 tools/build-docs'

      - name: 'Build documentation'
        run: 'mkdocs build --strict'

      - name: 'Upload Pages artifact'
        uses: 'actions/upload-pages-artifact@v4'
        with:
          path: 'site'

  deploy:
    needs: 'build'
    runs-on: 'ubuntu-latest'
    environment:
      name: 'github-pages'
      url: '${{ steps.deployment.outputs.page_url }}'
    steps:
      - name: 'Deploy to GitHub Pages'
        id: 'deployment'
        uses: 'actions/deploy-pages@v5'