Skip to content

Document UX flow for handling deprecated prebuilt rules #5783

Merged
nastasha-solomon merged 7 commits into
mainfrom
docs/deprecated-prebuilt-rules
Apr 16, 2026
Merged

Document UX flow for handling deprecated prebuilt rules #5783
nastasha-solomon merged 7 commits into
mainfrom
docs/deprecated-prebuilt-rules

Conversation

@nastasha-solomon
Copy link
Copy Markdown
Member

@nastasha-solomon nastasha-solomon commented Apr 3, 2026

Summary

Fixes https://github.com/elastic/docs-content-internal/issues/941 by documenting the deprecated prebuilt rules workflow.

Previews

  • Manage detection rules | Handle deprecated prebuilt rules - New section that explains what deprecated means, where Elastic Security surfaces callouts (Installed Rules tab and rule details), and the options that users have for handling deprecated rules (delete vs duplicate-then-delete).
  • Monitor rule executions - Added an entry to the "You want" table for handling deprecated prebuilt rules.
  • Prebuilt rules - Added entry to hub page for sub-pages in the "Prebuilt rules" section.

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No
  1. If you answered "Yes" to the previous question, please specify the tool(s) and model(s) used (e.g., Google Gemini, OpenAI ChatGPT-4, etc.).

Tool(s) and model(s) used:
Claude + Composer 2

Add section on manage detection rules for deprecated prebuilt rules: UI
callouts, delete vs duplicate-and-delete, and link to rule updates.

Cross-link from prebuilt rules hub and monitor rule executions (table + note).

Related: elastic/docs-content-internal#941
Made-with: Cursor
@nastasha-solomon nastasha-solomon requested a review from a team as a code owner April 3, 2026 20:24
@nastasha-solomon nastasha-solomon self-assigned this Apr 3, 2026
@nastasha-solomon nastasha-solomon marked this pull request as draft April 3, 2026 20:26
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 3, 2026

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 3, 2026

✅ Vale Linting Results

No issues found on modified lines!


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.

@nastasha-solomon nastasha-solomon changed the title Document handle deprecated prebuilt rules (9.4+) Document UX flow for handling deprecated prebuilt rules Apr 13, 2026
@nastasha-solomon nastasha-solomon marked this pull request as ready for review April 13, 2026 15:42
Copy link
Copy Markdown
Contributor

@dplumlee dplumlee left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good to me @nastasha-solomon, thanks!

Comment thread solutions/security/detect-and-alert/manage-detection-rules.md Outdated
Co-authored-by: Davis Plumlee <56367316+dplumlee@users.noreply.github.com>
Copy link
Copy Markdown
Member

@florent-leborgne florent-leborgne left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, I would just question whether this needs to be in the very first sections of the page?

@nastasha-solomon nastasha-solomon merged commit 02adeac into main Apr 16, 2026
7 checks passed
@nastasha-solomon nastasha-solomon deleted the docs/deprecated-prebuilt-rules branch April 16, 2026 01:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants