docs-ci.yml

name: Docs CI

on:
  push:
    branches:
      - main
  pull_request:

permissions:
  contents: read

jobs:
  validate-test-build:
    runs-on: ubuntu-latest

    steps:
      - name: Check out repository
        uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: Install Python dependencies
        run: |
          python -m pip install --upgrade pip
          python -m pip install pytest PyYAML multilingualprogramming

      - name: Validate multilingual docs metadata
        run: python scripts/validate_multilingual_docs.py --strict-freshness

      - name: Run docs tests
        run: python -m pytest _tests -q

      - name: Set up Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: "3.3"
          bundler-cache: true

      - name: Build Jekyll site
        run: bundle exec jekyll build --baseurl "/docs"

      - name: Check internal links
        run: python scripts/check_internal_links.py --site-dir _site --base-path /docs

      - name: Check Pages artifact
        run: python scripts/check_pages_artifact.py --site-dir _site --base-path /docs