Files
computer-playbook/roles/web-app-docs/files/python
kevinveenbirkenbachandClaude Opus 5 1fe353c225 feat(web-app-docs): render the documentation under the configured design title
web-svc-design declares title: true and web-app-docs does not override it, so resolve_branding yields the role's README H1. Nothing applied it: neither files/Dockerfile nor templates/design.js.j2 set a title, so the merged design spec asserting it in the tab, the header, the breadcrumbs and the mobile drawer would have run and failed.

Pass the resolved title to the container as DOCS_DESIGN_TITLE and let conf.py set html_title from it, which is the one value sphinxawesome derives all four of those surfaces from. The assignment is guarded on a non-empty value, so a deployment with the replacement disabled keeps Sphinx's own default built from project and release.

The designer side solved this in roles/web-app-sphinx/templates/Dockerfile.j2 with -D html_title at image-build time (35de016936). That cannot work here: web-app-docs does not build Sphinx into the image, it runs infinito_docs.server, which builds each version on demand, so only a runtime value reaches that build. conf.py already reads DOCS_VERSION from the environment the same way.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-10-15 22:39:07 +02:00
..