release notes switch to docs-builder yaml

[SylvainJuge]

EDIT: you can ignore this PR description and most of the conversation, the intermediate changes have already been merged as separate PRs.

This PR now contains the final switch from markdown release notes to the YAML generated by docs-builder.

Generation of the changelog bundles at release time is covered by #1047

---

Opened as a draft at this is a work-in-progress migration to using docs-builder to generate changelog entries and release notes.

Instructions provided here were used as a reference: elastic/elasticsearch#140795 (comment)

This will re-generate changelog entries from pull-requests and generate bundles, which emulates how each PR should have been gradually added to the changelog and how changelog bundles should be merged together at each release:

./wip-changelog.sh

All the PRs that are part of the changelog have beep properly labelled so they can fit one of the defined types.

For upstream dependency updates, they are currently labelled with enhancement, as they most often bring new enhancement and features from the SDK and the upstream implementation.

Next steps:

• review all TODOs in this PR and either create issues/PRs in docs-builder or provide ways to achieve what is necessary.
• find a way to generate github release notes markdown from a single bundle
  • we could decide to make this optional and link to docs directly
  • UPDATE: using workaround described in add ability to generate markdown for GH releases docs-builder#3057
• generate changelog in markdown to replace current static release-notes
  • we could decide to make this optional and link to docs directly
  • UPDATE: it hasn't been updated since 1.5.0, so I've decided to remove it.
• add automation in CI to require new PRs to be tagged so they are included in future changelogs + add changelog entries automatically
• remove ./wip-changelog.sh
• make it ready for merge: catch-up with any merged PR in the mean time

[lcawl]

I don't have authority to push commits to this PR, so I created SylvainJuge#1

[lcawl]

I created SylvainJuge#2 to hopefully address the current docs build error.

[github-actions]

📋 Changelog

⚠️ Cannot generate changelog: no matching type label found on this PR.

🔖 Add one of these type labels to your PR:

Label	Type
breaking-change	breaking-change
bug	bug-fix
deprecation	deprecation
feature	feature
enhancement	enhancement
changelog:upstream-update	enhancement
docs	docs
documentation	docs

🔖 To skip changelog generation or configure label rules, see docs/changelog.yml.

[github-actions]

🔍 Preview links for changed docs

• docs/release-notes/breaking-changes.md
• docs/release-notes/deprecations.md
• docs/release-notes/index.md
• docs/release-notes/known-issues.md

[github-actions]

✅ Vale Linting Results

No issues found on modified lines!

---

The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

[SylvainJuge]

I've updated the PR to contain only the final step of the migration process: replace current release notes in documentation with the changelog bundles.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: b349f666-5b5f-4317-a692-59395aa7b819

📥 Commits

Reviewing files that changed from the base of the PR and between b100c12 and 2d40535.

📒 Files selected for processing (5)

• docs/release-notes/breaking-changes.md
• docs/release-notes/deprecations.md
• docs/release-notes/index.md
• docs/release-notes/known-issues.md
• docs/releases/1.10.0.amend-1.yaml

---

📝 Walkthrough

Walkthrough

This change migrates the release notes documentation from a static, manually-maintained format to a dynamic system. The breaking-changes, deprecations, known-issues, and main index pages are updated to use Sphinx changelog directives that source entries from the /releases/ directory. Four release notes documents are modified to replace hardcoded template sections and placeholder text with directive blocks (:::{changelog}), and a new release entry file (1.10.0.amend-1.yaml) is added to document a security item for version 1.10.0.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

• 🛠️ Update Documentation: Commit on current branch
• 🛠️ Update Documentation: Create PR

Warning

Review ran into problems

🔥 Problems

Timed out fetching pipeline failures after 30000ms

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}