Skip to content

ci: fix Docs workflow and drop duplicate Gradle cache - #440

Merged
andrii-bodnar merged 2 commits into
masterfrom
ci/fix-docs-and-gradle-cache
Nov 16, 2026
Merged

andrii-bodnar merged 2 commits into
masterfrom
ci/fix-docs-and-gradle-cache

Conversation

@katerina20

Copy link
Copy Markdown
Collaborator

Fixes two CI problems that already exist on master. Neither is related to the Gradle 9 upgrade in #439.

Docs workflow

Every Docs run since 2026-09-24 has failed with:

The 'arguments' parameter is no longer supported for gradle/actions/setup-gradle.

#413 bumped gradle/actions/setup-gradle from v3 to v6, and later versions removed the arguments input. Because of this, no Javadoc has been published since the 2026-09-07 release.

setup-gradle now only sets up Gradle, and the tasks run as explicit steps: ./gradlew build and ./gradlew javadoc. Deployment to gh-pages from build/docs/javadoc is unchanged.

Duplicate Gradle cache

The Tests workflow cached Gradle files twice: through actions/setup-java (cache: 'gradle') and through gradle/actions/setup-gradle. The setup-gradle docs advise against combining the two because they can interfere. This removes the setup-java cache; setup-gradle already caches dependencies and wrapper distributions.

Testing

  • Ran ./gradlew build and ./gradlew javadoc locally on this branch's toolchain (Gradle 7.6.4, JDK 8). Both pass and the Javadoc site is generated.
  • Parsed the workflow files with a strict YAML check. It flags the two arguments inputs and the duplicate cache on master and finds no problems on this branch.
  • The Docs workflow hasn't run through a real release yet. It only runs on the release dispatch, so the first actual test will be the next release.

Merging with #439

Both PRs change the setup-java block in basic.yml, so whichever merges second has a small conflict. To resolve it, keep #439's java-version list (8 and 17) and drop cache: 'gradle'. docs.yml merges without conflicts.

🤖 Generated with Claude Code

katerina20 and others added 2 commits November 15, 2026 12:50
gradle/actions/setup-gradle no longer supports the 'arguments' input, so
since the v3 -> v6 bump in #413 every Docs run has failed before building
and no Javadoc has been published. setup-gradle now only configures
Gradle, and build and javadoc run as plain ./gradlew steps. Deployment to
gh-pages is unchanged.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The Tests workflow cached Gradle User Home twice: setup-java's
cache: 'gradle' and setup-gradle. The setup-gradle docs advise against
combining them because they interfere with each other. setup-gradle
already caches dependencies and wrapper distributions.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@andrii-bodnar
andrii-bodnar merged commit 6c375e7 into master Nov 16, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants