docs.yml

name: Deploy docs

on:
  push:
    tags:
      - 'v*'
  workflow_dispatch:

jobs:
  deploy:
    runs-on: ubuntu-24.04

    steps:
      - uses: actions/checkout@v5

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.13'

      - name: Install docs dependencies
        run: |
          python -m pip install --upgrade pip
          # TODO: prepare_env docs
          python -m venv .venvs/docs
          source .venvs/docs/bin/activate
          python -m pip install --group="docs"

      - name: Build docs
        env:
          MKDOCS_SITE_URL: https://finecode-dev.github.io
        run: |
          source .venvs/docs/bin/activate
          mkdocs build

      - name: Deploy to finecode.github.io
        uses: peaceiris/actions-gh-pages@v4
        with:
          personal_token: ${{ secrets.PAGES_DEPLOY_TOKEN }}
          external_repository: finecode-dev/finecode.github.io
          publish_branch: main
          publish_dir: ./site