docs: rewrite theory.md as Advanced Features guide #95

	name: CI

	on:
	push:
	branches: ["**"]
	pull_request:

	jobs:
	lint:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4
	- uses: actions/setup-python@v5
	with:
	python-version: "3.12"
	- name: Run ruff
	run: pip install uv && uvx ruff check .

	rust-test:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4
	- uses: dtolnay/rust-toolchain@stable
	- uses: Swatinem/rust-cache@v2
	- name: Run clippy perf checks
	run: cargo clippy --lib -- -W clippy::perf
	- name: Run Rust tests
	run: cargo test

	python-test:
	runs-on: ubuntu-latest
	strategy:
	matrix:
	python-version: ["3.10", "3.11", "3.12"]
	steps:
	- uses: actions/checkout@v4
	- uses: dtolnay/rust-toolchain@stable
	- uses: actions/setup-python@v5
	with:
	python-version: ${{ matrix.python-version }}
	- name: Install dependencies
	run: pip install uv && uv sync --all-extras
	- name: Run Python tests
	run: .venv/bin/pytest tests/ -v --tb=short
	env:
	CI: "true"

Provide feedback