Merged
Conversation
Contributor
Contributor
Vale Linting ResultsSummary: 3 suggestions found 💡 Suggestions (3)
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. |
szabosteve
approved these changes
Apr 20, 2026
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
3 participants
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
Restructures the Workflows docset from feature-organized into outcome-organized IA, per the Workflows Vision & Execution Plan. First of several planned PRs — lays the structural foundation so content work can land in smaller, reviewable follow-ups.
No existing pages are rewritten. Content is moved, reparented, and lightly reframed at the intro/title level. Four new outcome-section landing pages point at existing reference material. All old URLs redirect.
How to review
explore-analyze/toc.yml— this is the core change.What changed
New top-level outcome sections:
New parent index pages: Get started, Workflow authoring techniques, Reference.
Reparented content (URLs change, redirects added):
setup.mdandget-started.md→ under Get starteddata.md,author-workflows.md,monitor-troubleshoot.md,manage-workflows.md→ under Authoring techniquesdata/templating.md→templating.md(flattened, under Reference)triggers/*andsteps/*reparented intoc.ymlonly — URLs unchangedRetired:
workflows/core-components.md: A short navigation-hub page that wrapped Triggers, Steps, and Connectors in the old IA. In the new IA, the Reference section lists these directly, so the wrapper is redundant. The Triggers/Steps/Data framing is preserved in the "Key concepts" section ofworkflows.md. Redirects to the landing page.workflows/use-cases.md: An empty hidden stub (frontmatter + H1 only, no body). The four new outcome-section landing pages (Automate security operations, Manage detection rules at scale, Automate observability workflows, Build AI-augmented automation) are the new use-case discovery surface. Redirects to the landing page.Cross-repo link updates: Security alerts docs and Agent Builder docs updated to point at new paths.
Generative AI disclosure