This is an automated email from the ASF dual-hosted git repository.
oscerd pushed a commit to branch camel-4.22.x
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/camel-4.22.x by this push:
new 078de833e3bd ci: scope the local docs build to components 4.22.x so PR
doc validation resolves xrefs (#25748)
078de833e3bd is described below
commit 078de833e3bdd5cc81910ff435220c501de7ea35
Author: Andrea Cosentino <[email protected]>
AuthorDate: Wed Aug 26 07:54:49 2026 +0200
ci: scope the local docs build to components 4.22.x so PR doc validation
resolves xrefs (#25748)
The PR doc validation job runs camel-website's antora-local-build.sh in
"quick"
mode, which builds the local checkout and resolves everything else from the
published site-manifest.json. Which components come from the local sources
is
decided by the components filter in docs/source-watch.yml.
On main that filter is active and names components/next. On this branch it
was
left commented out, so the filter is empty and the local build is not
scoped:
Antora then tries to resolve the whole components namespace out of the local
checkout, which does not carry every page. Every xref into components::
fails,
433 of them, all in files this branch has never touched. The failure is
therefore branch-level rather than caused by any particular PR - it
reproduces
on any PR targeting camel-4.22.x.
Uncomment the filter with this branch's own version, 4.22.x, matching what
docs/components/antora.yml and
core/camel-core-engine/src/main/docs/antora.yml
already declare. Components other than the local one then come from the site
manifest, as they do on main.
Signed-off-by: Andrea Cosentino <[email protected]>
Co-authored-by: Claude Opus 5 (1M context) <[email protected]>
---
docs/source-watch.yml | 5 ++---
1 file changed, 2 insertions(+), 3 deletions(-)
diff --git a/docs/source-watch.yml b/docs/source-watch.yml
index bb64106e8070..d38967dda2fd 100644
--- a/docs/source-watch.yml
+++ b/docs/source-watch.yml
@@ -23,8 +23,7 @@
branch_includes: main
start_path_includes: docs/components,components-starter
components:
-# uncomment to work only on components
-# - name: components
-# version: next
+ - name: components
+ version: 4.22.x
# uncomment to work only on the user manual
# - name: manual
