Render features and enhancements separately in release notes

[lcawl]

Summary

Instead of the current "Features and enhancements" section that is created in the changelog render command output and the changelog directive, this PR generates separate "Features" and "Enhancements" sections.

Similar to the handling of the "Highlights" section, there's an option in the changelog directive to show each changelog's description too.

Details

feature and enhancement now render as separate Features and Enhancements sections. Empty sections are still omitted, so a patch release with only enhancements will not show a Features heading.

:description-visibility: accepts comma-separated tokens, including keep-feature-descriptions. You can combine overlays:

:description-visibility: keep-feature-descriptions, keep-highlight-descriptions

Deep links that used -features-enhancements need to move to -features / -enhancements. That is documented in docs/syntax/changelog.md.

With :dropdowns: set, "Features" uses the same {dropdown} rendering as "Highlights". Without that option, "Features" stay flat bullets. "Enhancements" and the other list sections are unchanged.

Area headers show only when :subsections: is also set. That applies to "Features", "Highlights", and the other dropdown sections (breaking changes still group by subtype).

Tests

When I change the Cloud Serverless release notes to use this new option:

:::{changelog}
:cdn: cloud-serverless
:highlights:
:description-visibility:  keep-highlight-descriptions, keep-feature-descriptions
:link-visibility: keep-links
:::

... it renders like this:

If I drop the keep-feature-descriptions clause from the directive, it looks like this:

If I add the :dropdowns: clause, it looks like this:

If I also add the :subsections: clause, that works too:

Generative AI disclosure

1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?

• Yes
• No

2. If you answered "Yes" to the previous question, please specify the tool(s) and model(s) used (e.g., Google Gemini, OpenAI ChatGPT-4, etc.).

Tool(s) and model(s) used: Cursor Grok 4.6

[github-actions]

Docs preview (local build)

Handbook preview: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/4065/

Sample changed pages:

• docs/syntax/changelog.md

[github-actions]

Approved.

---

What is this? | From workflow: PR Review

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.