Retitle the Fleet data retention tutorials with task-based titles - #7853
Draft
vishaangelova wants to merge 2 commits into
Draft
Retitle the Fleet data retention tutorials with task-based titles#7853vishaangelova wants to merge 2 commits into
vishaangelova wants to merge 2 commits into
Conversation
Co-authored-by: Cursor <cursoragent@cursor.com>
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. |
2 tasks
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
The four ILM tutorials under Data streams were titled and navigated as
Scenario 1–Scenario 4, which left the left nav showing nothing but the numbers. The numbers don't encode a sequence — the pages are alternatives, and every cross-reference between them treats them as such — so the label was one the reader couldn't decode without going back to the hub. This PR gives each page a verb-first H1 that states the outcome and a short nav title that differentiates at a glance, and drops the content-type prefix from the two tutorial titles in the same section.No URLs, filenames, or heading anchors change, so no redirects are needed.
Resolves #7852
Changes
navigation_titlevalues fordata-streams-scenario1.mdthroughdata-streams-scenario4.md. The nav labels drop the verb because the parent entry already supplies it, and repeating "Apply an ILM policy to" four times would push the distinguishing words to the right of every label. Scenario 3's H1 also now states its outcome (one data stream in one namespace) rather than its setup.reference/fleet/data-streams-ilm-tutorial.md: Drops theTutorials:prefix from the H1, renames the Identify your scenario heading, and rewrites the list so each entry leads with the page's task and follows with the mechanism it uses, which is what makes the options easy to tell apart.reference/fleet/data-streams-pipeline-tutorial.md: Drops theTutorial:prefix from the H1.Scenario Nreferences with descriptive link text, and normalizes inbound link text for both tutorial pages, which had drifted into four variants across the docset.Nav before and after
Notes for review
7701-fleet-namespace-ilm-policybranch so it can updatedata-streams-namespace-ilm.md, which doesn't exist onmainyet. GitHub will retarget this tomainonce Document assigning an ILM policy to an integration namespace #7808 merges.scenario1–scenario4. Renaming the files would pull in redirects for every page plus the legacymapped_pagesentries, so that's left out of scope.Generative AI disclosure
Tool(s) and model(s) used: Cursor / Claude Opus 5