Skip to content

Fix documentation inputs and enabled uber-JAR configuration cache - #68

Merged
rpalcolea merged 2 commits into
mainfrom
fix/documentation-and-uberjar-cache
Nov 5, 2026
Merged

rpalcolea merged 2 commits into
mainfrom
fix/documentation-and-uberjar-cache

Conversation

@rpalcolea

Copy link
Copy Markdown
Member

build clojuredoc snapshots the entire project directory, causing Gradle validation failures when unrelated tasks produce outputs. Enabled uber-JAR tasks also capture project and task state during execution, preventing strict configuration-cache use.

This change fixes those paths in two focused commits:

  • Model documentation source files, relative source-directory paths, classpath, options, and metadata as inputs while retaining the public DirectoryProperty API and generated source links.
  • Declare uber-JAR inputs and wire runtime archives lazily during configuration. Preserve task names, archive naming, manifest/signature exclusions, consumer customization, disabled-by-default behavior, and the existing selection of already-realized Jar tasks.
  • Convert the failure characterizations into successful regressions and document the verified scope and remaining limits.

Validation:

  • Full ./gradlew build with the test JVM on JDK 17: 146 tests passed, none failed or skipped; plugin validation and existing Java 8 toolchain tests passed.
  • Strict ordinary configuration cache and Isolated Projects on Gradle 8.0, 9.2.1, and 9.8.2 using version-appropriate isolation settings; 28 additional regression cases passed on 9.8.2.
  • Single-project, locally configured sibling, and nested builds; cold cache storage, warm reuse, and deleted-output regeneration.
  • Actual HTML, source links, static assets, and archive contents after source, dependency, documentation-option, and metadata edits. Changing a runtime-only JAR rebuilds the uber-JAR without recompiling application sources.

No new Gradle/JDK support floor is declared. The verified scope uses project-local configuration and does not establish whole-plugin isolation compatibility. Custom documentation writers must declare any additional files they read as task inputs.

@rpalcolea
rpalcolea merged commit d15f11a into main Nov 5, 2026
3 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.

1 participant