generate-dokka.yml

name: Deploy Dokka docs

on:
  push:
    branches:
      - develop # later on we should stick to main, since there will be the releases
  workflow_dispatch:

jobs:
    publish:
        runs-on: ubuntu-latest
        steps:
            - name: Checkout project
              uses: actions/checkout@v2 
              with:
                  fetch-depth: 0

            - name: Set up JDK
              uses: actions/setup-java@v3
              with:
                java-version: '17'
                distribution: 'temurin'
                cache: gradle

            - name: Validate Gradle wrapper
              uses: gradle/wrapper-validation-action@e6e38bacfdf1a337459f332974bb2327a31aaf4b

            - name: Generate Dokka docs
              run: make doc/generate-kdocs
              env:
                GITHUB_USER: ${{ github.actor }}
                GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

            - name: Deploy docs 🚀
              uses: JamesIves/github-pages-deploy-action@v4.2.5
              with:
                  branch: gh-pages
                  clean: false
                  folder: build/dokka/htmlMultiModule
                  target-folder: docs