(Disclaimer: I'm new to Gradle community slack. If...
# docs
t
(Disclaimer: I'm new to Gradle community slack. If I'm posting in the wrong place/manner, please do let me know.) tl;dr; Please categorize the "fixed issues" listing in release notes. In the Gradle release notes "fixed issues" section, there are often quite a lot of things listed, and they are of varying relevance/usefulness to anyone trying to understand what's really been fixed. Typically I'm looking for functional bug fixes and performance improvements, and all of the "fix doc info" and "fix punctuation" issues are just a distraction in this case. It would be nice if the issues in this table could be organized into categories (as with the analogous information that IDEA's release notes provide). Notice the signal-to-noise ratio of the 8.8 release notes, for example: https://docs.gradle.org/8.8/release-notes.html?_gl=1*1ry7vuj*_ga*OTQyODQzNjkzLjE2OTI[…].*_ga_7W7NC6YNPT*MTcxNzQzNzIwMi42OC4wLjE3MTc0MzcyMDIuNjAuMC4w Example of how IDEA's categorization is really much easier to read: https://youtrack.jetbrains.com/articles/IDEA-A-2100661977/IntelliJ-IDEA-2024.1.2-241.17011.79-build-Release-Notes?_ga=2.24205050.1597409904.1717432795-943381524.1691692911&_gac=1.92545775.1714148239.CjwKCAjwoa2xBhACEiwA1sb1BEmZLlsLnTGeMWjU1WfhB7MX9x-x4D9eOGEZSoGI_uHluuIt9Df_0xoCwzYQAvD_BwE&_gl=1*4s3c0i*_gcl_aw*R0NMLjE3MTQxNDgyMzIuQ2p3S0NBandvYTJ4QmhBQ0Vpd0Exc2IxQkVtWkxsc0xuVEdlTVdqVTFXZmhCN01YOXgteDREOWVPR0VaU29HSV91SGx1dUl0OURmXzB4b0N3ellRQXZEX0J3RQ..*_gcl_au*ODg1NTc1OTEuMTcxNjkyNDg2MQ..*_ga*OTQzMzgxNTI0LjE2OTE2OTI5MTE.*_ga_9J976DJZ68*MTcxNzQzODQ5Mi4xMzMuMC4xNzE3NDM4NDkyLjYwLjAuMA.. Is this something for which I should file a documentation issue in GitHub?
l
Hi Travis, thanks for the feedback. We had a community member who was excited to update the docs, and he sent in many PRs that needed to be more favorably named. I will be more strict on documentation PR titles to avoid this in the future. If this continues to be an issue, I will update our release process to ignore PRs labeled "documentation" under "Fixed Issues". As this is a first-time offense, I am still learning/deciding on the best course of action.
t
Sounds good, thanks Laura.