Repository navigation
docs: restructure Discover around goals, with a classic mode hub and task pages (#4898) - #9014
Draft
florent-leborgne wants to merge 17 commits into
Draft
florent-leborgne wants to merge 17 commits into
florent-leborgne wants to merge 17 commits into
Conversation
Contributor
Elastic Docs AI PR menuCheck the box to run an AI review for this pull request.
Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team. |
florent-leborgne
force-pushed
the
docs-issue-4898-classic-hub
branch
from
November 4, 2026 20:30
0b25765 to
36cf5fd
Compare
florent-leborgne
changed the title
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…ask pages (#4898) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…overview type (#4898) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
#4898) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…des (#4898) - Rewrite the Discover index around what readers want to do. - Replace the task map in the introduction with a pointer to the index. - Fold the single document guide into Inspect documents. - Add mode tabs to Search for relevance, with an ES|QL path. - Add ES|QL pointers on the classic-only guides. - Move Analyze your data with AI into the ES|QL hub. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
#4898) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…page (#4898) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…4898) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
- Fix wording: "may" and a joining semicolon, "dropdown" and "disabled". - Move applies_to tags to the start of their list items and fix a malformed one. - Declare type: how-to on the relevance and document explorer pages. - Expand KQL on first use and trim the explore fields description. - Say that Discover remembers the last mode, and update stale links to the renamed introduction. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…stics pages (#4898) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…tion Move the query modes, default mode, and remembered mode to the introduction. Add short sections on tabs and on saving and sharing. Replace the duplicate task list with a where-to-start list in the index. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…ents (#4898) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
florent-leborgne
force-pushed
the
docs-issue-4898-classic-hub
branch
from
November 5, 2026 10:15
2a8b2ab to
96c351d
Compare
This branch has not been 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.
Summary
This PR is part of #4898. It restructures the Discover docs around what readers want to do. The 525-line "Explore fields and data with Discover" tutorial becomes a "How Discover works" page, its other content moves to pages that each do one job, classic mode gets its own hub like the one ES|QL mode already has, and the Discover page becomes a hub that points readers to the right guide. It is stacked on the #8973 PR and targets that branch until it merges.
Hub and foundations
explore-analyze/discover.md: now a hub. A "Where to start" list points to the foundations page, the first-query tutorial, and the mode switch guide. Four goal groups follow: query your data, shape what your queries return and show, understand your data, and save and share your explorations. Tasks that work in only one mode name it.explore-analyze/discover/discover-get-started.md: now "How Discover works" (overview, same URL). It explains what you see on screen, the two query modes with the default mode for each version, tabs, saving and sharing, and the context-aware experiences.Classic mode hub and classic-only guides
use-classic-mode.md(new): overview with a "When you need this | Guide" table, mirroringuse-esql.md. It also holds the data view and time range steps that only apply in classic mode.search-and-filter-classic.md,add-fields-to-data-views.md,visualize-field.md(new): moved from the tutorial. Searching and filtering with KQL, Lucene, and filters, adding a runtime field, and opening a field in Lens.show-field-statistics.md,run-pattern-analysis-discover.md: the steps tell readers to switch to classic mode first. Both move under the new hub in the navigation.search-and-filter-classic.md,add-fields-to-data-views.md,show-field-statistics.md: each gets a short pointer for readers in ES|QL mode.Task pages moved from the tutorial
explore-fields.md,inspect-documents.md,compare-documents.md,copy-and-share-documents.md,work-with-tabs.md,generate-alerts-from-discover.md(new), andanalyze-discover-data-with-ai.md(new, in the ES|QL hub in the navigation).inspect-documents.md: also holds the classic-only actions to open a document on its own page or see the documents around it.explore-fields.md: adds the Add breakdown action, which splits the chart by a field.discover-search-for-relevance.md: has synced tabs for ES|QL mode and classic mode, with an ES|QL example.troubleshoot/kibana/discover-empty-fields.md(new): the empty fields FAQ from the tutorial, as a troubleshooting page.explore-analyze/_snippets/discover-cancel-query.md(new): the cancel-query text that applies to every query type, included inesql-results.mdandsearch-and-filter-classic.md.esql-results.mdalso gets the partial results note.explore-analyze/discover/document-explorer.md: the hero image shows ES|QL mode.Navigation and links
redirects.yml,explore-analyze/toc.yml,troubleshoot/toc.yml, and inbound links: every moved anchor has a redirect, and links in this repository point straight to the new pages.The tutorial's "Save your Discover session" section was dropped because
save-open-search.mdalready covers it in full.Generative AI disclosure
Tool(s) and model(s) used: Claude Code with Claude Sonnet 5.5. I moved existing text without rewriting it where possible. The hub, the "How Discover works" page, and the relevance tabs are new prose, and I checked their claims against the existing pages and Kibana source.
🤖 Generated with Claude Code