docs: keep typed-data code samples within mobile width #24

	name: CI

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

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

	- name: Set up Python 3.9
	# CI runs the latest 3.9.x patch. The exact-3.9.4 target-system pin lives in the
	# devcontainer and the demo, not CI (hosted runners no longer ship 3.9.4); ruff's
	# py39 target still guards against 3.10+ syntax. See docs/decisions/0007.
	uses: actions/setup-python@v5
	with:
	python-version: "3.9"

	- name: Bootstrap
	run: make bootstrap

	- name: Verify (lint + tests)
	run: make verify

	- name: Drift gate (generated models + schema docs match the schema)
	# Regenerate on the same Python 3.9 target and fail if the committed artifacts differ.
	# xsdata is pinned (==25.7, the last 3.9-supporting line) so generation is byte-stable.
	# See docs/decisions/0008.
	run: \|
	make generate
	make gen-schema-docs
	paths="src/acoustic_dataset/models docs/reference/schema"
	if [ -n "$(git status --porcelain -- $paths)" ]; then
	echo "::error::Generated artifacts are stale. Run 'make generate' and 'make gen-schema-docs' and commit."
	git --no-pager diff -- $paths
	git status --porcelain -- $paths
	exit 1
	fi
	echo "Generated models and schema docs are in sync with the schema."

	- name: Build HTML docs (strict)
	run: make docs

Provide feedback