update docs #27

	name: Deploy MkDocs to GitHub Pages

	on:
	push:
	branches:
	- master
	- docs
	paths:
	- 'docs/**'
	- 'mkdocs.yml'
	- '.github/workflows/deploy-docs.yml'

	permissions:
	contents: write

	jobs:
	deploy:
	runs-on: ubuntu-latest
	steps:
	- name: Checkout repository
	uses: actions/checkout@v4
	with:
	fetch-depth: 0 # Fetch all history for proper versioning

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

	- name: Install Poetry
	uses: snok/install-poetry@v1
	with:
	version: 2.0.0
	virtualenvs-create: true
	virtualenvs-in-project: true

	- name: Load cached dependencies
	id: cached-poetry-dependencies
	uses: actions/cache@v4
	with:
	path: .venv
	key: ${{ runner.os }}-poetry-${{ hashFiles('**/poetry.lock') }}

	- name: Install dependencies
	if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
	run: \|
	poetry install --with docs

	- name: Configure Git user
	run: \|
	git config --local user.email "github-actions[bot]@users.noreply.github.com"
	git config --local user.name "github-actions[bot]"

	- name: Deploy documentation
	run: \|
	poetry run mkdocs gh-deploy --force

Provide feedback