From 5e58bed38b35bc988418df52f2de2b897a81f286 Mon Sep 17 00:00:00 2001 From: Mohith Shrivastava Date: Sun, 21 Jun 2026 09:41:28 -0400 Subject: [PATCH] ci: trigger docs build on changes to build inputs The Docs Build and Deploy workflow only ran when docs/**, mkdocs.yml, requirements-docs.txt, or the workflow itself changed. But the rendered site also depends on: - .mkdocs/** - the macros module (.mkdocs/macros) and theme overrides (.mkdocs/overrides) referenced by mkdocs.yml - specification/a2a.proto - source for the proto_to_table macros - scripts/build_docs.sh - the build entrypoint the workflow invokes Changes to these could break the build or alter every rendered page without triggering CI (e.g. the macros.py anchor fix in #1966 ran no build check). Add them to the push and pull_request path filters. --- .github/workflows/docs.yml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 39617bf77..e35eb7fdb 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -7,18 +7,24 @@ on: paths: - ".github/workflows/docs.yml" - "scripts/deploy_root_files.sh" + - "scripts/build_docs.sh" - "requirements-docs.txt" - "mkdocs.yml" - "docs/**" + - ".mkdocs/**" + - "specification/a2a.proto" pull_request: branches: - main paths: - ".github/workflows/docs.yml" - "scripts/deploy_root_files.sh" + - "scripts/build_docs.sh" - "requirements-docs.txt" - "mkdocs.yml" - "docs/**" + - ".mkdocs/**" + - "specification/a2a.proto" release: types: - published