Skip to content

Show lifecycle badges on API group overview rows - #4520

Merged
akira28 merged 2 commits into
mainfrom
feature/api-explorer-group-overview
Oct 20, 2026
Merged

akira28 merged 2 commits into
mainfrom
feature/api-explorer-group-overview

Conversation

@akira28

@akira28 akira28 commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Endpoint rows on API group overview pages now show the same beta, preview and deprecated badges as the operation page.

Affects: API reference

Prompt summary: Fix elastic/docs-eng-team#1098 on this branch: group overview pages list endpoints without lifecycle badges, so readers cannot tell an endpoint is deprecated or experimental until they open it. Show each endpoint's badges in the overview list.

Why

A group overview such as Behavioral analytics lists "Get behavioral analytics collections" with no badges. The operation page shows it as experimental and deprecated. Readers only find out after they click through.

What

Badge data on overview rows

ApiOverviewRow carries the operation's availability badge and its deprecated flag. ApiOverviewBuilder builds both with AvailabilityBadge.FromOperation, the helper the operation page uses, so the two pages agree.

Row layout

The row partial renders the badges next to the title, using the existing api-title-badges markup. A small CSS rule lets the title and badges wrap on narrow rows.

Verify

dotnet test tests/Elastic.ApiExplorer.Tests

Check on the preview

Group overview pages listed endpoints without their beta, preview or deprecated state, so readers had to open each operation to see it. Each row now shows the same badges as the operation page.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@akira28
akira28 requested a review from a team as a code owner October 19, 2026 19:13
@akira28
akira28 requested a review from Mpdreamz October 19, 2026 19:13
Comment thread src/Elastic.ApiExplorer/Landing/_Partials/_ApiGroupRow.cshtml
Comment thread tests/Elastic.ApiExplorer.Tests/OverviewRowLifecycleTests.cs Outdated
@github-actions

Copy link
Copy Markdown
Contributor

Docs preview (local build)

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

The row is one link, and a tap on an interactive badge inside it opened the operation instead of the lifecycle popover. The row badge is now static, and tests cover the rendered badges for beta, deprecated and plain operations.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@akira28
akira28 merged commit f0f4b8f into main Oct 20, 2026
32 checks passed
@akira28
akira28 deleted the feature/api-explorer-group-overview branch October 20, 2026 07:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant