Document how withPluginClasspath is broken

[TWiStErRob]

Is your feature request related to a problem? Please describe.

I've been successfully using withPluginClasspath for years now, so I'm really wondering what's wrong with it.

Describe the solution you'd like

Any kind of documentation other than stating that "it's broken". For example a link to Gradle issue, or blog post.

https://github.com/autonomousapps/dependency-analysis-gradle-plugin/blob/6df0bfa7166832bd2468ec9482f8d48dbeae577e/testkit/README.asciidoc#L5

Additional context

I got here from WithPluginClasspathUsage which just links to your plugin:

Avoid usage of GradleRunner#withPluginClasspath, which is broken. Instead use something like https://github.com/autonomousapps/dependency-analysis-gradle-plugin/tree/main/testkit#gradle-testkit-support-plugin

[autonomousapps]

I feel like you're asking me to write a blog post 😂 which I'm open to.

[TWiStErRob]

I would be happy with a oneliner too, anything more concrete and reproducible than "it doesn't work".

[autonomousapps]

Forgot I actually wrote about it at https://dev.to/autonomousapps/defensive-development-gradle-plugin-development-for-busy-engineers-486c.