Repository navigation
Conversation
`ApiOperation.Deprecated` is now the one fact that the page badge, the overview rows, the search exporter and the sidebar read. The renamed `IApiOperationNavigationModel` exposes it, and `NavigationRenderNode` projects it. The tree hash includes it only when set, so trees without a deprecated leaf keep their cached `nav-tree-<hash>` id. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A reader now sees that an operation is deprecated before opening it. The row keeps its width: the title is struck through and dimmed like a deprecated property, the method chip turns grey, and a hidden word keeps the link name honest for screen readers. Rows that are not deprecated render the same markup as before. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The design-system tree now marks a deprecated operation the same way as the legacy sidebar. One `nav-tree__link--deprecated` modifier strikes the title and greys the method badge through its tone tokens. A hidden word names the state for screen readers. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The index already stores `api.deprecated`, but the `_source` filter left it out and the response had no field for it. Navigation search results now carry `deprecated`, which is false for docs pages, so the search card can mark a deprecated operation. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A reader who finds a deprecated operation in search now sees the same red "Deprecated" badge that its page shows, before clicking through. The card reuses the global `.deprecated-badge` class. The schema keeps `deprecated` optional, so an API and a frontend deployed at different times still parse each other. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…dge markup The search card reused the filled chip the explorer draws on deprecated parameters, so the same word looked different from the badge on the page it links to. The card now emits the title badge's own classes and inherits its outlined look from the same rules. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…an arguments Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…o the chip's height A search card now treats a deprecated operation like its sidebar row: the title is struck through and dimmed and the method chip turns grey. The page's outlined Deprecated badge stays beside the title, sized like the method chip so it sits inside the title line instead of stretching the row. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The badge wrapper inherited the title's 24px line height and aligned its content to the bottom of that box, so the badge sat 3.5px below the text centre. As an atomic inline with its own line height it centres within 1px and still stops the row's hover underline at the title text. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Member
Author
Contributor
Docs preview (local build)Handbook preview: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/4668/ Sample changed pages: |
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.


Why
Deprecatedbadge, but the sidebar and the search results give no sign, so a reader can open a deprecated operation without warning.api.deprecatedsince API search: find an operation by the words of its path, id, and group #4666, but nothing reads it back.What
Deprecatedbadge beside the title.deprecatedfor each hit, and oneApiOperation.Deprecatedaccessor feeds the page, the overview rows, the sidebar and the index.Notes
main. The visual check againstmainshows no diffs, and a nav tree's content hash only changes when the tree contains a deprecated leaf.🤖 Generated with Claude Code