publish-docs.yml

name: Build and Deploy Maven Site to GitHub Pages

on:
  workflow_dispatch:
  workflow_run:
    workflows: ["Build any branch"]
    types: [completed]
    branches: [ main ]

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

concurrency:
  group: pages
  cancel-in-progress: false

env:
  MAVEN_COMMAND: ./mvnw
  MAVEN_CLI_COMMON: "-e -B"

jobs:
  build-site:
    if: github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success'
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
    - uses: actions/checkout@v7
      with:
        ref: ${{ github.event.workflow_run.head_sha || github.sha }}
    - uses: ./.github/actions/jdk-setup
    # Tests run (no -DskipTests) so JaCoCo writes target/jacoco.exec and target/jacoco-it.exec;
    # the site step renders the unit and integration coverage reports from them.
    - name: Build project (runs tests for coverage data)
      run: ${{ env.MAVEN_COMMAND }} ${{ env.MAVEN_CLI_COMMON }} clean install
    # Only the integration module has site content (src/site); its <distributionManagement><site>
    # url is the Pages root, so it is the published site. Build just that module (the same command
    # building.adoc documents for local use). The archetype module has no site and no
    # distributionManagement, which is what broke the previous reactor-wide `site site:stage`.
    - name: Generate Maven site (integration module)
      run: ${{ env.MAVEN_COMMAND }} ${{ env.MAVEN_CLI_COMMON }} site -pl integration -Dproject.build.outputTimestamp=$(date -u +%Y-%m-%dT%H:%M:%SZ)
    - name: Upload Pages artifact
      uses: actions/upload-pages-artifact@v5
      with:
        path: integration/target/site/

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