From 13073cb4115d1c4cf525a11111caf23add4ac814 Mon Sep 17 00:00:00 2001 From: Sushant Poudel <215148952+sushant-me@users.noreply.github.com> Date: Mon, 7 Sep 2026 01:01:03 +0545 Subject: [PATCH] docs: clarify path filters for git submodule changes Path filters in `on..` are compared against the parent repository's diff, which records a submodule as a single entry at the submodule's own path. Filtering on a path inside the submodule therefore never matches, because the parent repository does not track those paths. --- .../actions/reference/workflows-and-actions/workflow-syntax.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/actions/reference/workflows-and-actions/workflow-syntax.md b/content/actions/reference/workflows-and-actions/workflow-syntax.md index 0953709ba987..159b9a0343df 100644 --- a/content/actions/reference/workflows-and-actions/workflow-syntax.md +++ b/content/actions/reference/workflows-and-actions/workflow-syntax.md @@ -175,6 +175,8 @@ on: ### Git diff comparisons {% data reusables.actions.workflows.triggering-a-workflow-paths5 %} +> [!NOTE] +> **Changes to files in a git submodule:** For {% data variables.product.prodname_actions %} to detect changes to files inside a git submodule, filter on the path to the top-level submodule itself, not on paths within the submodule. For example, if a submodule is checked out at `submodules/my-library`, use `paths: - submodules/my-library/**`. The paths to individual files inside the submodule are not tracked by the parent repository's workflow filters. ## `on.schedule`