docs.yml

name: docs
on:
  workflow_dispatch:
  push:
    branches:
      - 'dev/master'
    paths:
      - 'docs/**'
      - 'src/api/**'
      - 'settings.gradle.kts'
      - 'build.gradle.kts'
      - 'gradle.properties'
      - 'mkdocs.yml'
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: 3.x
      - uses: actions/setup-java@v4
        with:
          java-version: 21
          distribution: temurin
      - uses: gradle/actions/setup-gradle@v4
        with:
          cache-read-only: true
      - run: ./gradlew apiJavadoc
        env:
          GIT_HASH: ${{ steps.vars.outputs.git_hash }}
      - run: pip install mkdocs-material
      - run: mkdocs gh-deploy --force
      - run: ./gradlew --stop