docs.yml

name: Docs

# Publishes Dokka HTML to the gh-pages branch. See .github/SETUP_PAGES.md for one-time Pages setup.
on:
  push:
    branches: [master, main]
  workflow_dispatch:

permissions:
  contents: write

concurrency:
  group: docs-gh-pages
  cancel-in-progress: true

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

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

      - name: Grant execute permission for gradlew
        run: chmod +x gradlew

      - name: Generate Dokka HTML
        run: ./gradlew :pinflow:dokkaGeneratePublicationHtml --no-daemon --stacktrace

      - name: Verify Dokka output
        run: test -f pinflow/build/dokka/html/index.html

      - name: Deploy to gh-pages branch
        uses: peaceiris/actions-gh-pages@v4
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: pinflow/build/dokka/html
          publish_branch: gh-pages
          force_orphan: true