Skip to content

Document the legacy plugin id removal - #3093

Merged
nedtwigg merged 2 commits into
mainfrom
docs/legacy-plugin-id-breaking
Sep 18, 2026
Merged

nedtwigg merged 2 commits into
mainfrom
docs/legacy-plugin-id-breaking

Conversation

@nedtwigg

@nedtwigg nedtwigg commented Sep 17, 2026

Copy link
Copy Markdown
Member

#3086 stopped publishing the plugin marker for the legacy com.diffplug.gradle.spotless id, and the
next release ships that change without a changelog entry. This adds one.

The marker has been published for every release from 1.1 through 8.10.2, so
plugins { id 'com.diffplug.gradle.spotless' version '<next>' } will fail with "was not found" for
the first time in the project's history. The redirect class is still on the classpath and still
prints its migration message when the id is applied from an existing classpath, so only resolution
through the plugin portal changes.

Not documented, deliberately: #3086 also declares a historical capability
com.diffplug.gradle.spotless:spotless-plugin-gradle. No module by that name was ever published —
the former coordinates were com.diffplug.gradle.spotless:spotless (1.2.0 through 2.4.1) — so the
declaration conflicts with nothing and there is nothing for users to act on. Worth fixing in the
build separately, or dropping.

Found while reviewing everything merged since 8.10.2, the same review that caught #3089.

🤖 Generated with Claude Code

nedtwigg and others added 2 commits September 17, 2026 16:48
#3086 stopped publishing the marker for the legacy
`com.diffplug.gradle.spotless` id and added a historical capability, both
of which can break a consumer's build. Neither was in the changelog.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Drops the capability entry: the declared capability
com.diffplug.gradle.spotless:spotless-plugin-gradle never existed as a
published module, so it conflicts with nothing and there is nothing for
users to act on. The real former coordinates were
com.diffplug.gradle.spotless:spotless (1.2.0 through 2.4.1).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@nedtwigg
nedtwigg merged commit 1d9f712 into main Sep 18, 2026
31 checks passed
@nedtwigg
nedtwigg deleted the docs/legacy-plugin-id-breaking branch September 18, 2026 00:50
@Goooler

Goooler commented Sep 18, 2026

Copy link
Copy Markdown
Member

Or we can revert b667bcb and still try to publish the legacy plugin coordinate. The removal could be landed in the next major. I removed it due to the main reason for the blocker of 403 error, but the real cause might be the SNAPSHOT flag instead of namespace permission.

@nedtwigg

Copy link
Copy Markdown
Member Author

I think it's good that it has been removed. We've been generating a very loud warning for years now. The real breaking change happened a long time ago.

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