This message was deleted.

Do you have any particular change in mind? Regarding the documentation: documentation is getting content updates/refactor already with normal releases. For example in Gradle 8.5 you can find new Core Concepts and also some additional tutorials and visuals. We did some small visual changes in 7.x (see difference between 7.3 and current). Note: this is a releases channel where we normally announce releases and it's not generally used for discussions.

The last time I read most of the userguide (pdf) was back in versions 7.0~7.5 I skimmed through the current (8.5) userguide and there have been some major enhancements both in organization and in visuals. What I mostly meant was that I heard release 9.0 will be accompanied by a major API cleanup (is this true?), as such it would be a good opportunity to fix anything missing. For example on page ~1630 the link to the ANTLR core plugin (https://docs.gradle.org/8.5/userguide/antlr_plugin.pdf#antlr_plugin) results to a 404, actually same for most of them except the java library/platform, groovy and scala plugins. On page 346 the "Applying plugins using the buildscript{} block" is only present in groovy. Same with 348. There are little errors like there sort of sprinkled all over, but the frequency decreased with respect to previous versions I believe there are also some parts that are not available in the userguide (pdf or not) and are present only as single-subject web-pages. That being said the documentation did improve a lot. I was ultimately just curious to know what changes are mostly expected on the documentation side of things with the 9.0 release. (Also, I know gradle is very extensive, but 1637 pages for a userguide is... not a small number)

Thanks for the feedback! > For example on page ~1630 the link to the ANTLR core plugin (https://docs.gradle.org/8.5/userguide/antlr_plugin.pdf#antlr_plugin) results to a 404, actually same for most of them except the java library/platform, groovy and scala plugins. > On page 346 the "Applying plugins using the buildscript{} block" is only present in groovy. Same with 348. > There are little errors like there sort of sprinkled all over, but the frequency decreased with respect to previous versions Could you maybe open an issue to the issue tracker? > What I mostly meant was that I heard release 9.0 will be accompanied by a major API cleanup (is this true?), as such it would be a good opportunity to fix anything missing. You are probably thinking about Provider API migration that is planned for Gradle 9. This technically won't be a cleanup, but a change of the API. But yeah it's definitely an opportunity to fix some things. And if you feel there is anything missing in the docs, please open an issue to the issue tracker.

Hi @Anze Sodja I opened a new issue tracker if you're interested: #27323