deploy.yml

name: Deploy developer.seatable.com (mkdocs material with github pages)

on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main

permissions:
  contents: write

jobs:
  quality:
    name: Quality checks
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v6

      - name: Check documentation quality
        run: python3 tests/validate_docs.py

  check-links:
    name: Check links
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v6

      - name: Check links in markdown files
        uses: lycheeverse/lychee-action@v2
        with:
          args: "--verbose --no-progress --root-dir docs --exclude-path 'docs/includes.md' --exclude 'http://127*' --exclude 'http://localhost' './docs/**/*.md'"
          fail: true

  deploy:
    runs-on: ubuntu-latest
    needs:
      - quality
      - check-links
    if: github.ref == 'refs/heads/main'
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

      - uses: actions/setup-python@v6
        with:
          python-version: 3.x

      - name: Install dependencies
        run: pip install -r requirements.txt

      - name: Generate llms.txt and llms-full.txt
        run: python3 scripts/generate_llms_txt.py

      - name: Build with mkdocs (strict mode)
        run: mkdocs build --strict --verbose
        env:
          MKDOCS_GIT_COMMITTERS_APIKEY: ${{ secrets.MKDOCS_GIT_COMMITTERS_APIKEY }}
          CI: true

      - name: Deploy to GitHub Pages
        run: mkdocs gh-deploy --force
        env:
          MKDOCS_GIT_COMMITTERS_APIKEY: ${{ secrets.MKDOCS_GIT_COMMITTERS_APIKEY }}
          CI: true