name: Vale Documentation Linter

on:
  pull_request:
    paths:
      - 'docs/**/*.md'
      - 'docs/**/*.mdx'
      - '**/*.md'
      - '.vale.ini'
      - '.github/styles/**'

permissions:
  contents: read

jobs:
  vale:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Install Vale
        run: |
          curl -fsSL -o vale.tar.gz \
            https://github.com/errata-ai/vale/releases/download/v3.0.5/vale_3.0.5_Linux_64-bit.tar.gz
          tar -xzf vale.tar.gz
          sudo mv vale /usr/local/bin/vale
          vale --version

      - name: Sync Vale packages
        run: vale sync

      - name: Run Vale
        run: vale --minAlertLevel=error docs