lint (#657) #174

	# source: https://github.com/sphinx-notes/pages
	name: Deploy Sphinx documentation to Pages

	on:
	push:
	branches: [master] # branch to trigger deployment

	jobs:
	pages:
	runs-on: ubuntu-22.04
	environment:
	name: github-pages
	url: ${{ steps.deployment.outputs.page_url }}
	permissions:
	pages: write
	id-token: write
	steps:
	- uses: actions/checkout@v4

	- name: Install uv
	uses: astral-sh/setup-uv@v7
	with:
	enable-cache: true

	- name: Install pandoc
	run: sudo apt install -y pandoc

	- name: Set up Python
	run: uv python install

	- name: Install Python dependencies
	run: uv sync --extra docs

	- name: Build docs
	run: cd docs && uv run make html

	- name: Generate LLM agent reference markdown
	run: \|
	uv run jupyter nbconvert --to markdown docs/source/llm.ipynb --output llm.md --output-dir docs/build/html/

	- name: Setup Pages
	uses: actions/configure-pages@v4

	- name: Upload artifact
	uses: actions/upload-pages-artifact@v3
	with:
	path: docs/build/html

	- id: deployment
	name: Deploy to GitHub Pages
	uses: actions/deploy-pages@v4

Provide feedback