deploy_docs.yml

name: Deploy Docs

on:
  push:
    tags:
      - 'v*.*.*'  # Only trigger on version tags (e.g., v1.0.0)

permissions:
  contents: write

jobs:

  deploy:

    name: Deploy Docs

    runs-on: ubuntu-latest

    steps:

      - 
        name: Checkout
        uses: actions/checkout@v4

      - 
        name: Setup Python
        uses: actions/setup-python@v5
        with:
          python-version: 3.x

      - 
        name: PIP Install mkdocs-material
        run: |
          pip install mkdocs-material

      - 
        name: PIP Install mkdocstrings
        run: |
          pip install mkdocstrings[python]>=0.18

      - 
        name: MKDocs Deploy
        run: |
          mkdocs gh-deploy --force