docs: overhaul retrieval optimization guide #288

	name: Deploy Documentation

	on:
	push:
	branches:
	- docs

	# Rebuild when a new stable release or pre-release is published,
	# since the home page shows release metadata baked at build time.
	release:
	types:
	- published
	- released
	- prereleased

	# Allow triggering a rebuild manually from the Actions UI.
	workflow_dispatch:

	permissions:
	contents: write

	jobs:
	build:
	runs-on: ubuntu-latest

	steps:
	- name: Checkout repository
	uses: actions/checkout@v4
	with:
	fetch-depth: 0
	ref: docs

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

	- name: Install MkDocs and dependencies
	run: pip install -r requirements-docs.txt

	- name: Deploy to GitHub Pages
	run: mkdocs gh-deploy --force --clean --remote-branch gh-pages

Navigation Menu