name: Docs Check

on:
  pull_request:
  push:
    branches:
      - main

jobs:
  lint-and-links:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Markdown lint
        uses: DavidAnson/markdownlint-cli2-action@v20
        with:
          globs: |
            **/*.md

      - name: Validate local markdown links
        run: ./scripts/check_markdown_links.sh

  translation-parity:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Build translation parity report
        run: ./scripts/translation_parity_report.sh parity-report.md

      - name: Publish report to step summary
        run: cat parity-report.md >> "$GITHUB_STEP_SUMMARY"

      - name: Upload parity report artifact
        uses: actions/upload-artifact@v4
        with:
          name: translation-parity-report
          path: parity-report.md