ci: docs deploy without installing the app (private dep); commit Open… #52

	name: Deploy Documentation

	on:
	push:
	branches: [main]
	paths:
	- 'docs/**'
	- 'mkdocs.yml'
	- 'src/ad_buyer/interfaces/api/main.py'
	workflow_dispatch:

	permissions:
	contents: write
	pages: write

	jobs:
	deploy:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4

	- uses: actions/setup-python@v5
	with:
	python-version: '3.11'

	# Docs deploys must not install the app: it depends on the private
	# iab-agentic-primitives, which CI cannot clone. The OpenAPI JSON is a
	# committed artifact regenerated locally via scripts/generate_openapi.py.
	- name: Install docs toolchain
	run: pip install "mkdocs-material>=9.5.0" "mkdocs-mermaid2-plugin>=1.1.0"

	- name: Deploy to GitHub Pages
	run: mkdocs gh-deploy --force

Provide feedback