Docs / Build PR runs only make -C docs setupenv && make -C docs test. That target is a single-version sphinx-build; it never invokes docs/_utils/multiversion.sh, javadoc-multiversion.sh or javadoc.sh, and the job installs no JDK 8.
So a typo in the per-branch JDK case list, a wrong JAVA_HOME_* variable name, or a bad relative path is only discovered after merge, on the publish workflow — which has a history of failing silently.
.github/workflows/docs-pr.yml also filters on docs/**, faq/**, manual/**, changelog/**, upgrade_guide/**, so a change confined to .github/workflows/** gets no check at all.
Fix: what #909 proposed — add make -C docs multiversion to the PR workflow, a JDK 8 setup-java step, and .github/workflows/** to its paths:. A full multiversion build is slow, so it may need to be opt-in by label or limited to a couple of representative branches.
Refs: https://scylladb.atlassian.net/browse/DRIVER-1086
Jira: https://scylladb.atlassian.net/browse/DRIVER-1089
Docs / Build PRruns onlymake -C docs setupenv && make -C docs test. That target is a single-versionsphinx-build; it never invokesdocs/_utils/multiversion.sh,javadoc-multiversion.shorjavadoc.sh, and the job installs no JDK 8.So a typo in the per-branch JDK case list, a wrong
JAVA_HOME_*variable name, or a bad relative path is only discovered after merge, on the publish workflow — which has a history of failing silently..github/workflows/docs-pr.ymlalso filters ondocs/**,faq/**,manual/**,changelog/**,upgrade_guide/**, so a change confined to.github/workflows/**gets no check at all.Fix: what #909 proposed — add
make -C docs multiversionto the PR workflow, a JDK 8setup-javastep, and.github/workflows/**to itspaths:. A full multiversion build is slow, so it may need to be opt-in by label or limited to a couple of representative branches.Refs: https://scylladb.atlassian.net/browse/DRIVER-1086
Jira: https://scylladb.atlassian.net/browse/DRIVER-1089