Migrate changelog workflows to unified release-notes reusable workflow

.github/workflows/pre-post-release.yml

@@ -74,9 +74,6 @@ jobs:
         with:
           github-token: ${{ steps.get_token.outputs.token }}
 
-      - name: Docs builder setup
-        uses: elastic/docs-actions/docs-builder/setup@v1
-
       - name: Create the release tag (post phase)
         if: inputs.phase == 'post'
         run: |
@@ -102,20 +99,6 @@ jobs:
         if: inputs.phase == 'post'
         run: bash ./.ci/release/post-release.sh
 
-      - name: Generate documentation changelog bundle (pre release)
-        if: inputs.phase == 'pre'
-        # we should use the 'edot-java-release' profile to generate the bundle:
-        #   docs-builder changelog bundle edot-java-release ${{ env.RELEASE_VERSION }}
-        # this does not yet allow to provide the generated content for description, so we have to use the explicit arguments.
-        run: |
-          description="$(.ci/changelog-bundle-description.sh)"
-          docs-builder changelog bundle \
-            --input-products 'edot-java * *' \
-            --output-products 'edot-java ${{ env.RELEASE_VERSION }} ga' \
-            --output docs/releases/${{ env.RELEASE_VERSION }}.yaml \
-            --description "${description}"
-          docs-builder changelog remove edot-java-release ${{ env.RELEASE_VERSION }}
-
       - name: Push the ${{ inputs.phase }} release branch
         run: |
           git add --all

.github/workflows/release-notes-changelog-file.yml

@@ -0,0 +1,13 @@
+name: Changelog file
+on:
+  workflow_run:
+    # Must match the `name:` field of the release-notes workflow in this repo.
+    workflows: ["release-notes"]
+    types: [completed]
+permissions: {}
+jobs:
+  changelog-file:
+    uses: elastic/docs-actions/.github/workflows/release-notes-changelog-file.yml@v1
+    permissions:
+      pull-requests: write
+      actions: read

.github/workflows/release-notes-comments.yml

@@ -0,0 +1,19 @@
+name: Changelog PR comments
+on:
+  workflow_run:
+    # Must match the `name:` field of the release-notes workflow in this repo.
+    workflows: ["release-notes"]
+    types: [completed]
+permissions: {}
+# The PR number is stable; do not cancel — two upstreams can complete close
+# together and cancelling mid-upsert risks leaving the wrong comment body.
+concurrency:
+  group: changelog-comments-${{ github.event.workflow_run.head_repository.full_name }}-${{ github.event.workflow_run.head_branch }}
+  cancel-in-progress: false
+jobs:
+  comment:
+    if: github.event.workflow_run.event == 'pull_request' && github.event.workflow_run.conclusion != 'cancelled'
+    uses: elastic/docs-actions/.github/workflows/release-notes-comments.yml@v1
+    permissions:
+      pull-requests: write
+      actions: read

.github/workflows/release-notes.yml

@@ -0,0 +1,14 @@
+name: release-notes
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, edited, labeled, unlabeled]
+  push:
+    branches: [main]
+permissions: {}
+jobs:
+  release-notes:
+    permissions:
+      contents: read
+      pull-requests: read
+      packages: read
+    uses: elastic/docs-actions/.github/workflows/release-notes.yml@v1

.github/workflows/release-step-3.yml

@@ -262,3 +262,47 @@ jobs:
             --verify-tag \
             --title="Release ${{ env.RELEASE_VERSION }}" \
             --notes='${{needs.generate-release-notes.outputs.notes}}'
+
+  bundle:
+    name: "Generate changelog bundle"
+    needs: create-github-release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: read
+      pull-requests: read
+    outputs:
+      bundle-path: ${{ steps.create.outputs.bundle-path }}
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ inputs.ref }}
+          persist-credentials: false
+      - name: Generate bundle description
+        id: description
+        run: echo "text=$(.ci/changelog-bundle-description.sh)" >> "$GITHUB_OUTPUT"
+      - name: Create bundle
+        id: create
+        uses: elastic/docs-actions/changelog/bundle-create-version@v1
+        with:
+          version: ${{ env.RELEASE_VERSION_TAG }}
+          description: ${{ steps.description.outputs.text }}
+          github-token: ${{ github.token }}
+
+  bundle-publish:
+    name: "Publish changelog bundle to S3"
+    needs: bundle
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+      packages: read
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ inputs.ref }}
+          persist-credentials: false
+      - name: Publish bundle to S3
+        uses: elastic/docs-actions/changelog/bundle-publish@v1
+        with:
+          bundle-path: ${{ needs.bundle.outputs.bundle-path }}

docs/docset.yml

@@ -1,3 +1,3 @@
 project: 'EDOT Java release notes'
 cross_links:
   - docs-content
@@ -9,6 +9,8 @@
 toc:
   - toc: release-notes
   - toc: reference/edot-java
+release_notes:
+  - product: edot-java
 subs:
   motlp: Elastic Cloud Managed OTLP Endpoint
   edot: Elastic Distribution of OpenTelemetry
@@ -23,4 +25,4 @@
   stack:   "Elastic Stack"
   es:   "Elasticsearch"
   kib:   "Kibana"
-  ls:   "Logstash"
+  ls:   "Logstash"

docs/release-notes/breaking-changes.md

@@ -15,6 +15,6 @@
 
 Breaking changes can impact your applications, potentially disrupting normal operations and their monitoring. Before you upgrade, carefully review the Elastic Distribution of OpenTelemetry Java breaking changes and take the necessary steps to mitigate any issues.
 
-:::{changelog} /releases/
+:::{changelog} edot-java
 :type: breaking-change
 :::

docs/release-notes/deprecations.md

@@ -17,6 +17,6 @@
 
 Review the deprecated functionality for Elastic Distribution of OpenTelemetry Java. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade. To learn how to upgrade, check out [Upgrade](docs-content://deploy-manage/upgrade.md).
 
-:::{changelog} /releases/
+:::{changelog} edot-java
 :type: deprecation
 :::

docs/release-notes/index.md

@@ -17,7 +17,7 @@
 
 To check for security updates, go to [Security announcements for the Elastic stack](https://discuss.elastic.co/c/announcements/security-announcements/31).
 
-:::{changelog} /releases/
+:::{changelog} edot-java
 :type: all
 :release-dates:
 :::

docs/release-notes/known-issues.md

@@ -13,6 +13,6 @@
 
 # Elastic Distribution of OpenTelemetry Java known issues
 
-:::{changelog} /releases/
+:::{changelog} edot-java
 :type: known-issue
 :::