build-docs.yaml

# Regenerates the documentation for the "Command Reference" section of the site https://maester.dev
name: build-docs

on:
  # Runs on pushes targeting the default branch
  push:
    branches: ["main"]
  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:

# Sets permissions of the GITHUB_TOKEN to allow updates to the repository
permissions:
  contents: write
  id-token: write
  checks: write

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Update docs
        run: ./build/Update-CommandReference.ps1
        shell: pwsh

      - name: Update repo
        run: |
          if [[ `git status --porcelain` ]]; then
            # Changes
            echo "Updating command reference"
            git config --global user.name 'Merill Fernando'
            git config --global user.email 'merill@users.noreply.github.com'
            git add -A && git commit -m "Bot: Updating command reference"
            git push
          else
            # No changes
            echo "No changes"
          fi