Update Elasticsearch release notes automation (#132930)

* Update breaking changes and deprecations

* update release note tagging

* revert tagging change

* Update tests after template changes

* [docs] Add support for overriding entries in the release notes (#133592)

* [docs] Add support for overriding entries in the release notes

* Update changelog bundles with overrides

* Use ga instead of comming tag

* Update tests after template change

---------

Co-authored-by: Brian Seeders <[email protected]>

Author: charlotte-hoblik

build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/release/ChangelogEntry.java

@@ -43,6 +43,7 @@ public class ChangelogEntry {
     private Breaking breaking;
     private Highlight highlight;
     private Deprecation deprecation;
+    private String entryOverride;
 
     private static final ObjectMapper yamlMapper = new ObjectMapper(new YAMLFactory());
 
@@ -125,6 +126,14 @@ public void setDeprecation(Deprecation deprecation) {
         this.deprecation = deprecation;
     }
 
+    public String getEntryOverride() {
+        return entryOverride;
+    }
+
+    public void setEntryOverride(String entryOverride) {
+        this.entryOverride = entryOverride;
+    }
+
     @Override
     public boolean equals(Object o) {
         if (this == o) {
@@ -140,12 +149,13 @@ public boolean equals(Object o) {
             && Objects.equals(type, that.type)
             && Objects.equals(summary, that.summary)
             && Objects.equals(highlight, that.highlight)
-            && Objects.equals(breaking, that.breaking);
+            && Objects.equals(breaking, that.breaking)
+            && Objects.equals(entryOverride, that.entryOverride);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(pr, issues, area, type, summary, highlight, breaking);
+        return Objects.hash(pr, issues, area, type, summary, highlight, breaking, entryOverride);
     }
 
     @Override

build-tools-internal/src/main/resources/templates/breaking-changes.md

@@ -22,29 +22,35 @@ for(bundle in changelogBundles) {
     if (coming) {
         print "\n"
         print "```{applies_to}\n"
-        print "stack: coming ${version}\n"
+        print "stack: ga ${version}\n"
         print "```"
     }
 %>
 ## ${unqualifiedVersion} [elasticsearch-${versionForIds}-breaking-changes]
+
 <%
     if (!changelogsByTypeByArea['breaking']) {
-        print "\nNo breaking changes in this version.\n"
+        print "There are no breaking changes associated with this release.\n"
     } else {
         for (team in (changelogsByTypeByArea['breaking'] ?: [:]).keySet()) {
-            print "\n${team}:\n";
+            print "${team}:\n";
 
             for (change in changelogsByTypeByArea['breaking'][team]) {
-                print "* ${change.summary} [#${change.pr}](https://github.com/elastic/elasticsearch/pull/${change.pr})"
-                if (change.issues != null && change.issues.empty == false) {
-                    print change.issues.size() == 1 ? " (issue: " : " (issues: "
-                    print change.issues.collect { "[#${it}](https://github.com/elastic/elasticsearch/issues/${it})" }.join(", ")
-                    print ")"
+                if (!change.entryOverride) {
+                    print "* ${change.summary} [#${change.pr}](https://github.com/elastic/elasticsearch/pull/${change.pr})"
+                    if (change.issues != null && change.issues.empty == false) {
+                        print change.issues.size() == 1 ? " (issue: " : " (issues: "
+                        print change.issues.collect { "[#${it}](https://github.com/elastic/elasticsearch/issues/${it})" }.join(", ")
+                        print ")"
+                    }
+                } else {
+                    print change.entryOverride;
                 }
                 print "\n"
             }
+            print "\n"
         }
 
-        print "\n\n"
+        print "\n"
     }
 }

build-tools-internal/src/main/resources/templates/deprecations.md

@@ -26,14 +26,14 @@ for(bundle in changelogBundles) {
     if (coming) {
         print "\n"
         print "```{applies_to}\n"
-        print "stack: coming ${version}\n"
+        print "stack: ga ${version}\n"
         print "```"
     }
 %>
 ## ${unqualifiedVersion} [elasticsearch-${versionForIds}-deprecations]
 <%
     if (!changelogsByTypeByArea['deprecation']) {
-        print "\nNo deprecations in this version.\n"
+        print "\nThere are no deprecations associated with this release.\n"
     } else {
         for (team in (changelogsByTypeByArea['deprecation'] ?: [:]).keySet()) {
             print "\n${team}:\n";

build-tools-internal/src/main/resources/templates/index.md

@@ -34,7 +34,7 @@ for(bundle in changelogBundles) {
 
 if (coming) {
     print "```{applies_to}\n"
-    print "stack: coming ${version}\n"
+    print "stack: ga ${version}\n"
     print "```"
     print "\n"
 }
@@ -59,18 +59,24 @@ for (changeType in ['features-enhancements', 'fixes', 'regression']) {
     }
 %>
 ### ${ TYPE_LABELS.getOrDefault(changeType, 'No mapping for TYPE_LABELS[' + changeType + ']') } [elasticsearch-${versionForIds}-${changeType}]
+
 <% for (team in changelogsByTypeByArea[changeType].keySet()) {
-    print "\n${team}:\n";
+    print "${team}:\n";
 
     for (change in changelogsByTypeByArea[changeType][team]) {
-        print "* ${change.summary} [#${change.pr}](https://github.com/elastic/elasticsearch/pull/${change.pr})"
-        if (change.issues != null && change.issues.empty == false) {
-            print change.issues.size() == 1 ? " (issue: " : " (issues: "
-            print change.issues.collect { "[#${it}](https://github.com/elastic/elasticsearch/issues/${it})" }.join(", ")
-            print ")"
+        if (!change.entryOverride) {
+            print "* ${change.summary} [#${change.pr}](https://github.com/elastic/elasticsearch/pull/${change.pr})"
+            if (change.issues != null && change.issues.empty == false) {
+                print change.issues.size() == 1 ? " (issue: " : " (issues: "
+                print change.issues.collect { "[#${it}](https://github.com/elastic/elasticsearch/issues/${it})" }.join(", ")
+                print ")"
+            }
+        } else {
+            print change.entryOverride.trim();
         }
         print "\n"
     }
+    print "\n"
 }
 }
 print "\n"

build-tools-internal/src/test/resources/org/elasticsearch/gradle/internal/release/ReleaseNotesGeneratorTest.breaking-changes.md

@@ -13,54 +13,54 @@ If you are migrating from a version prior to version 9.0, you must first upgrade
 % ## Next version [elasticsearch-nextversion-breaking-changes]
 
 ```{applies_to}
-stack: coming 9.1.0
+stack: ga 9.1.0
 ```
 ## 9.1.0 [elasticsearch-9.1.0-breaking-changes]
 
-No breaking changes in this version.
+There are no breaking changes associated with this release.
 
 ```{applies_to}
-stack: coming 9.0.10
+stack: ga 9.0.10
 ```
 ## 9.0.10 [elasticsearch-9.0.10-breaking-changes]
 
-No breaking changes in this version.
+There are no breaking changes associated with this release.
 
 ## 9.0.9 [elasticsearch-9.0.9-breaking-changes]
 
-No breaking changes in this version.
+There are no breaking changes associated with this release.
 
 ## 9.0.8 [elasticsearch-9.0.8-breaking-changes]
 
-No breaking changes in this version.
+There are no breaking changes associated with this release.
 
 ## 9.0.7 [elasticsearch-9.0.7-breaking-changes]
 
-No breaking changes in this version.
+There are no breaking changes associated with this release.
 
 ## 9.0.6 [elasticsearch-9.0.6-breaking-changes]
 
-No breaking changes in this version.
+There are no breaking changes associated with this release.
 
 ## 9.0.5 [elasticsearch-9.0.5-breaking-changes]
 
-No breaking changes in this version.
+There are no breaking changes associated with this release.
 
 ## 9.0.4 [elasticsearch-9.0.4-breaking-changes]
 
-No breaking changes in this version.
+There are no breaking changes associated with this release.
 
 ## 9.0.3 [elasticsearch-9.0.3-breaking-changes]
 
-No breaking changes in this version.
+There are no breaking changes associated with this release.
 
 ## 9.0.2 [elasticsearch-9.0.2-breaking-changes]
 
-No breaking changes in this version.
+There are no breaking changes associated with this release.
 
 ## 9.0.1 [elasticsearch-9.0.1-breaking-changes]
 
-No breaking changes in this version.
+There are no breaking changes associated with this release.
 
 ## 9.0.0 [elasticsearch-900-breaking-changes]
 

build-tools-internal/src/test/resources/org/elasticsearch/gradle/internal/release/ReleaseNotesGeneratorTest.deprecations.md

@@ -17,38 +17,38 @@ To give you insight into what deprecated features you’re using, {{es}}:
 % ## Next version [elasticsearch-nextversion-deprecations]
 
 ```{applies_to}
-stack: coming 9.1.0
+stack: ga 9.1.0
 ```
 ## 9.1.0 [elasticsearch-9.1.0-deprecations]
 
-No deprecations in this version.
+There are no deprecations associated with this release.
 
 ```{applies_to}
-stack: coming 9.0.10
+stack: ga 9.0.10
 ```
 ## 9.0.10 [elasticsearch-9.0.10-deprecations]
 
-No deprecations in this version.
+There are no deprecations associated with this release.
 
 ## 9.0.9 [elasticsearch-9.0.9-deprecations]
 
-No deprecations in this version.
+There are no deprecations associated with this release.
 
 ## 9.0.8 [elasticsearch-9.0.8-deprecations]
 
-No deprecations in this version.
+There are no deprecations associated with this release.
 
 ## 9.0.7 [elasticsearch-9.0.7-deprecations]
 
-No deprecations in this version.
+There are no deprecations associated with this release.
 
 ## 9.0.6 [elasticsearch-9.0.6-deprecations]
 
-No deprecations in this version.
+There are no deprecations associated with this release.
 
 ## 9.0.5 [elasticsearch-9.0.5-deprecations]
 
-No deprecations in this version.
+There are no deprecations associated with this release.
 
 ## 9.0.4 [elasticsearch-9.0.4-deprecations]
 
@@ -60,16 +60,16 @@ Search:
 
 ## 9.0.3 [elasticsearch-9.0.3-deprecations]
 
-No deprecations in this version.
+There are no deprecations associated with this release.
 
 ## 9.0.2 [elasticsearch-9.0.2-deprecations]
 
-No deprecations in this version.
+There are no deprecations associated with this release.
 
 ## 9.0.1 [elasticsearch-9.0.1-deprecations]
 
-No deprecations in this version.
+There are no deprecations associated with this release.
 
 ## 9.0.0 [elasticsearch-900-deprecations]
 
-No deprecations in this version.
+There are no deprecations associated with this release.

build-tools-internal/src/test/resources/org/elasticsearch/gradle/internal/release/ReleaseNotesGeneratorTest.index.md

@@ -22,7 +22,7 @@ To check for security updates, go to [Security announcements for the Elastic sta
 
 ## 9.1.0 [elasticsearch-9.1.0-release-notes]
 ```{applies_to}
-stack: coming 9.1.0
+stack: ga 9.1.0
 ```
 
 ### Highlights [elasticsearch-9.1.0-highlights]
@@ -47,9 +47,10 @@ Search:
 *  [#52](https://github.com/elastic/elasticsearch/pull/52)
 
 
+
 ## 9.0.10 [elasticsearch-9.0.10-release-notes]
 ```{applies_to}
-stack: coming 9.0.10
+stack: ga 9.0.10
 ```
 
 ### Features and enhancements [elasticsearch-9.0.10-features-enhancements]
@@ -59,6 +60,7 @@ Search:
 * Test changelog entry 10_1 [#10002](https://github.com/elastic/elasticsearch/pull/10002) (issues: [#10003](https://github.com/elastic/elasticsearch/issues/10003), [#10004](https://github.com/elastic/elasticsearch/issues/10004))
 
 
+
 ## 9.0.9 [elasticsearch-9.0.9-release-notes]
 
 ### Regressions [elasticsearch-9.0.9-regression]
@@ -68,6 +70,7 @@ Mappings:
 * Test changelog entry 9_1 [#9002](https://github.com/elastic/elasticsearch/pull/9002) (issues: [#9003](https://github.com/elastic/elasticsearch/issues/9003), [#9004](https://github.com/elastic/elasticsearch/issues/9004))
 
 
+
 ## 9.0.8 [elasticsearch-9.0.8-release-notes]
 
 ### Features and enhancements [elasticsearch-9.0.8-features-enhancements]
@@ -77,6 +80,7 @@ Indices:
 * Test changelog entry 8_1 [#8002](https://github.com/elastic/elasticsearch/pull/8002) (issues: [#8003](https://github.com/elastic/elasticsearch/issues/8003), [#8004](https://github.com/elastic/elasticsearch/issues/8004))
 
 
+
 ## 9.0.7 [elasticsearch-9.0.7-release-notes]
 
 ### Features and enhancements [elasticsearch-9.0.7-features-enhancements]
@@ -86,6 +90,7 @@ Cluster:
 * Test changelog entry 7_1 [#7002](https://github.com/elastic/elasticsearch/pull/7002) (issues: [#7003](https://github.com/elastic/elasticsearch/issues/7003), [#7004](https://github.com/elastic/elasticsearch/issues/7004))
 
 
+
 ## 9.0.6 [elasticsearch-9.0.6-release-notes]
 
 ### Features and enhancements [elasticsearch-9.0.6-features-enhancements]
@@ -95,6 +100,7 @@ Aggregation:
 * Test changelog entry 6_1 [#6002](https://github.com/elastic/elasticsearch/pull/6002) (issues: [#6003](https://github.com/elastic/elasticsearch/issues/6003), [#6004](https://github.com/elastic/elasticsearch/issues/6004))
 
 
+
 ## 9.0.5 [elasticsearch-9.0.5-release-notes]
 
 ### Features and enhancements [elasticsearch-9.0.5-features-enhancements]
@@ -104,6 +110,7 @@ Security:
 * Test changelog entry 5_1 [#5002](https://github.com/elastic/elasticsearch/pull/5002) (issues: [#5003](https://github.com/elastic/elasticsearch/issues/5003), [#5004](https://github.com/elastic/elasticsearch/issues/5004))
 
 
+
 ## 9.0.4 [elasticsearch-9.0.4-release-notes]
 
 
@@ -116,6 +123,7 @@ Mappings:
 * Test changelog entry 3_1 [#3002](https://github.com/elastic/elasticsearch/pull/3002) (issues: [#3003](https://github.com/elastic/elasticsearch/issues/3003), [#3004](https://github.com/elastic/elasticsearch/issues/3004))
 
 
+
 ## 9.0.2 [elasticsearch-9.0.2-release-notes]
 
 ### Fixes [elasticsearch-9.0.2-fixes]
@@ -125,6 +133,7 @@ Indices:
 * Test changelog entry 2_1 [#2002](https://github.com/elastic/elasticsearch/pull/2002) (issues: [#2003](https://github.com/elastic/elasticsearch/issues/2003), [#2004](https://github.com/elastic/elasticsearch/issues/2004))
 
 
+
 ## 9.0.1 [elasticsearch-9.0.1-release-notes]