docs: note inline data source picker for AIOps and data drift (#6879) - #7543
Open
florent-leborgne wants to merge 5 commits into
Open
docs: note inline data source picker for AIOps and data drift (#6879)#7543florent-leborgne wants to merge 5 commits into
florent-leborgne wants to merge 5 commits into
Conversation
From 9.5 and in serverless, AIOps tools and the data drift view open directly on the analysis page with an inline data source picker in the page header, replacing the intermediate Select Data View step. Co-authored-by: Cursor <cursoragent@cursor.com>
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. |
Contributor
Contributor
Elastic Docs Style Checker (Vale)Summary: 1 warning found
|
| File | Line | Rule | Message |
|---|---|---|---|
| explore-analyze/machine-learning/machine-learning-in-kibana.md | 17 | Elastic.Spelling | 'data's' is a possible misspelling. |
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.
Replaces stale screenshots on the AIOps Labs, Data drift, and ML getting-started pages to reflect the inline data view/Discover session picker that replaced the separate "Select Data View" page (#266672). Drops the version-scoped callout sentences in favor of the existing version-agnostic phrasing, which already covers both the old and new flows without needing to reference a removed UI element. Bolds page names for consistency with the rest of the corpus, and fixes a batch of pre-existing style issues (word choice, voice/tone, grammar) on the two AIOps/Data drift pages while in there. Closes #6879
…riptions Rewrites imperative step-by-step passages on the AIOps Labs and Data drift pages into descriptive, conceptual voice (what the feature does, not a literal click-sequence), matching the overview content type these pages are meant to be. No information dropped. Adds the missing frontmatter description field to both pages plus the anomaly detection tutorial.
florent-leborgne
marked this pull request as ready for review
July 28, 2026 20:10
nastasha-solomon
approved these changes
Jul 28, 2026
|
|
||
| ::::{warning} | ||
| This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. | ||
| This functionality is in technical preview and might be changed or removed in a future release. Elastic works to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. |
Member
There was a problem hiding this comment.
This should be an applies_to section-level tag, no?
Confirmed with the ML team that Data drift was marked GA in stack 9.4 (Kibana #252764 removed the tech preview badge from the UI in the same release). Replaces the unscoped technical-preview warning, which was stale for GA readers, with a section-level applies_to tag that preserves the preview state for the still-supported 9.0-9.3 range per the cumulative docs model, matching the pattern already used for Change point detection on the sibling AIOps Labs page.
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
Closes #6879. Kibana #266672 removed the intermediate Select Data View page for AIOps tools and Data Visualizer pages, replacing it with an inline data view/Discover session picker in the page header. This PR brings the docs in line with that change.
Screenshots (8) retaken and replaced to show the current inline picker UI:
explore-analyze/machine-learning/machine-learning-in-kibana.md: Data Visualizer, Data driftexplore-analyze/machine-learning/machine-learning-in-kibana/xpack-ml-aiops.md: Log rate analysis, Log pattern analysis, Change point detection, Selected change pointsexplore-analyze/machine-learning/anomaly-detection/ml-getting-started.md: two Data Visualizer field-statistics screenshotsWording fixes:
ml-getting-started.mdtold readers to "Click Select data view" — that button no longer exists. Reworded to describe the outcome ("Select thekibana_sample_data_logsdata source") instead of naming a specific control, so the instruction stays accurate for both the pre- and post-9.5 UI without needing version scoping.Data drift,AIOps Labs,Log rate analysis,Log pattern analysis,Change point detection) for consistency with the rest of the corpus and with the style guide's "bold names shown in the UI" rule — verified against the retaken screenshots that each is a literal page header.machine-learning-in-kibana.md,xpack-ml-aiops.md) from click-by-click instructions into descriptive, conceptual voice, better matching the overview content type these pages are meant to be. No information was dropped.descriptionfield to all three pages.Lifecycle fix (Data drift): while auditing the
applies_to/preview markers on these pages, found that the unscoped "technical preview" warning on Data drift was stale. Kibana issue #245828 and PR #252764 (v9.4.0) confirm the preview badge was removed from the product because the feature is "no longer in tech preview," and the ML team confirmed it was marked GA in stack 9.4. Replaced the warning with a section-levelapplies_totag (stack: ga 9.4+, preview 9.0-9.3,serverless: ga) that preserves the preview state for the still-supported 9.0-9.3 range per the cumulative docs model, matching the pattern already used for Change point detection on the sibling AIOps Labs page. Also verified the two other lifecycle markers on these pages (thega 9.4Zoom in/out date-picker tip, and Change point detection'spreview 9.0-9.4→ga 9.5+tag) against Kibana source/PR history — both are accurate, no change needed.Why this closes the issue
The issue's core ask is that the docs accurately reflect the product after the intermediate selection page was removed. I audited the full
docs-contentcorpus (not just these two pages) for the specific things the removal could have made stale:indexDataVisualizerPagedeep-link, other than the one inml-getting-started.md, now fixed.I deliberately did not add a version-scoped note stating users can now switch data views "without leaving the page" (an earlier draft of this PR did). A picker sitting in the page header is self-evidently reusable — there's no discoverability gap for a reader to get stuck on, and the only thing such a note would really convey is a comparison to a UI that most readers never saw, which is changelog framing rather than evergreen reference content.
Not in scope (flagged, not fixed)
xpack-ml-aiops.mdstructurally bundles three distinct tools (Log rate analysis, Log pattern analysis, Change point detection) in one overview page, each with enough procedural depth to function as its own how-to. Splitting these into linked pages would be a cleaner fit for the overview content type, but it's real IA work (new pages, redirects, cross-links) that deserves its own PR rather than being folded into this one.ml-getting-started.mdhas a larger set of pre-existing style issues (recurring "see"/"choose" word choice, gerund-led sentences, directional language) unrelated to this change — not touched here.Generative AI disclosure
Tool(s) and model(s) used: Claude Code (Claude Sonnet 5), with screenshots retaken manually by the author.
Resolves
Closes #6879