testssl.sh/.github/workflows/build_docs.yml

name: Build Documentation

on:
  pull_request:
    paths:
      - "doc/testssl.1.md"

jobs:
  build-docs:
    runs-on: ubuntu-26.04
    # Skip fork PRs: GITHUB_TOKEN can't push to a fork's branch
    if: github.event.pull_request.head.repo.full_name == github.repository

    steps:
      - name: Checkout repository
        uses: actions/checkout@v7
        with:
          ref: ${{ github.head_ref }}
          fetch-depth: 0

      - name: Install dependencies
        run: |
          sudo apt-get update
          sudo apt-get install -y pandoc make

      - name: Build documentation
        working-directory: doc
        run: make -B
        # -B ensures build when doc/testssl.1.md changes. When checking out the md file
        # it probably might have a time stamp which indicates nothing has changed

      - name: Commit and push generated doc files
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add -A
          if git diff --staged --quiet; then
            echo "No generated changes to commit"
          else
            git commit -m "Auto-generate docs from testssl.1.md [skip ci]"
            git push
          fi