.github/workflows/trigger-docs-update.yml

# Tell the bazel-contrib/bazel-docs repo that new commits have been merged to Bazel.
# It will do some pipeline logic and then update the Mintlify site.
name: Trigger update to bazel-docs
on:
  push:
    branches:
      - master
    paths:
      - 'docs/**'
      - 'src/main/java/**/*.java'
jobs:
  trigger-docs-update:
    runs-on: ubuntu-latest
    steps:
      - name: Trigger build of bazel-docs
        uses: peter-evans/repository-dispatch@28959ce8df70de7be546dd1250a005dd32156697 # v4
        with:
          repository: bazel-contrib/bazel-docs
          # Fine-grained PAT (https://github.com/settings/personal-access-tokens/new), which needs
          # to be exchanged once a year.
          # Scoped to the `bazel-contrib/bazel-docs` repository.
          # Requires "Read and write" permissions for "Contents" to be able to do the workflow dispatch.
          token: ${{ secrets.BAZEL_DOC_TRIGGER_TOKEN }}
          event-type: on-bazel-trigger
          client-payload: '{"commitHash": "${{ github.sha }}"}'