Update AHJs + websites #562

	name: Release Documentation

	permissions:
	contents: write

	concurrency:
	group: docs-${{ github.workflow }}-${{ github.ref }}
	cancel-in-progress: ${{ github.event_name == 'pull_request' }}

	on:
	pull_request:
	paths:
	- compass/**
	- docs/**
	- README.rst
	- .github/workflows/docs.yml
	- pyproject.toml
	- pixi.lock
	push:
	branches: [main]
	paths:
	- compass/**
	- docs/**
	- README.rst
	- .github/workflows/docs.yml
	- pyproject.toml
	- pixi.lock
	release:
	types: [created, published]
	workflow_dispatch:

	jobs:
	build_docs:
	name: Build docs
	runs-on: ubuntu-latest

	steps:
	- name: Pull Repo
	uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
	with:
	fetch-depth: 0
	fetch-tags: true

	- uses: prefix-dev/setup-pixi@5185adfbffb4bd703da3010310260805d89ebb11 # v0.9.6
	with:
	pixi-version: v0.69.0
	locked: true
	cache: false # Don't use cache because we use the ``pdoc`` environment
	environments: pdoc

	- name: Build Docs
	run: pixi run -e pdoc python-docs # This errors on warnings

	- name: deploy
	uses: peaceiris/actions-gh-pages@84c30a85c19949d7eee79c4ff27748b70285e453 # v4.1.0
	if: startsWith(github.ref, 'refs/tags/v')
	with:
	github_token: ${{ secrets.GITHUB_TOKEN }}
	publish_dir: ./docs/_build/html
	force_orphan: true
	full_commit_message: ${{ github.event.head_commit.message }}

Provide feedback