build-docs-dispatch.yaml

name: Build SDK References Documents (Manual)

on:
  workflow_dispatch:

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

jobs:
  build-docs:
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
    - name: Checkout
      uses: actions/checkout@v4

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

    - name: Setup Gradle
      uses: gradle/actions/setup-gradle@v4

    - name: Setup Pages
      uses: actions/configure-pages@v5

    - name: Generate Documentation
      run: ./gradlew dokkaGeneratePublicationHtml
    - name: Upload docs artifact
      uses: actions/upload-pages-artifact@v4
      with:
        path: ./docs
    - name: Deploy to GitHub Pages
      id: deployment
      uses: actions/deploy-pages@v4