Skip to content

[AlertZero] Add hidden scaffolding for the AlertZero docs - #8716

Merged
natasha-moore-elastic merged 2 commits into
mainfrom
nsolomon/alertzero-scaffolding
Oct 12, 2026
Merged

natasha-moore-elastic merged 2 commits into
mainfrom
nsolomon/alertzero-scaffolding

Conversation

@nastasha-solomon

@nastasha-solomon nastasha-solomon commented Oct 6, 2026 •

Copy link
Copy Markdown
Member

Summary

Fixes https://github.com/elastic/docs-content-internal/issues/1811.

This PR adds the AlertZero docs as hidden stub pages, so each page can be drafted in its own PR from main. It follows revision 5 of the AlertZero docs structure, tracked in https://github.com/elastic/docs-content-internal/issues/1472.

Stacked on #8651. AlertZero goes in the navigation that #8651 creates: between Manage and AI-assisted operations, with its privileges page under Access control. Retarget this PR to main after #8651 merges.

What changes

  • 19 hidden pages in solutions/security/alertzero/. Each has a title, a description, and one sentence on what it covers. Every file sits directly in that folder, with no subfolders, so moving a page in the navigation never changes its URL.
  • Navigation: Every page has a hidden entry in solutions/toc.yml. AlertZero comes after Manage and before AI-assisted operations. AlertZero privileges sits under Manage → Access control, next to Attack Discovery privileges.
  • Anchors for planned links: Configure Worker settings has an autonomy section, and Watches and Workers has a section for each Watch. Other pages can link to these anchors before they're drafted.

Not in this PR

  • Page content. Each page is drafted in its own PR, branched from main after this one merges.
  • Variables. They're in [AlertZero] Add variables for AlertZero terms #8715. The stubs use plain text, so this PR doesn't depend on that one.
  • Kibana settings reference entries for the AlertZero advanced setting.

For review

  • Lifecycle: Every page uses stack: preview 9.6 and serverless: security: preview as placeholders. Is AlertZero technical preview, beta, or GA in 9.6, and when does it reach serverless?

Verification

  • Full docs-builder build: 0 errors and 0 warnings. The 4 new hints are the same kind existing pages get: a parent page with children ("uses deep-linking with children").
  • All 19 pages build, and none of them appear in the navigation.

Previews

Stacked PRs don't generate previews, so previews appear after this PR is retargeted to main. Hidden pages don't appear in the preview's navigation. Open them directly, starting from the landing page:

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No
  1. Tool(s) and model(s) used: Claude Code (Claude Opus 5.5).

@github-actions

github-actions Bot commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@nastasha-solomon nastasha-solomon self-assigned this Oct 7, 2026
Base automatically changed from claude/elastic-security-nav-restructure-fbbbd7 to main October 9, 2026 19:58
nastasha-solomon and others added 2 commits October 9, 2026 15:59
Adds 19 hidden stub pages in solutions/security/alertzero/ and their
navigation entries, following revision 5 of the AlertZero docs structure.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@nastasha-solomon
nastasha-solomon force-pushed the nsolomon/alertzero-scaffolding branch from 8fc8c81 to ff7a7c5 Compare October 9, 2026 20:00
@github-actions

github-actions Bot commented Oct 9, 2026

Copy link
Copy Markdown
Contributor

✅ Elastic Docs Style Checker (Vale)

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.

@natasha-moore-elastic
natasha-moore-elastic marked this pull request as ready for review October 12, 2026 08:44
@natasha-moore-elastic
natasha-moore-elastic requested review from a team as code owners October 12, 2026 08:44

@leemthompo leemthompo left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I approve this TOC edit

@natasha-moore-elastic
natasha-moore-elastic added this pull request to the merge queue Oct 12, 2026
Merged via the queue into main with commit bb29ef1 Oct 12, 2026
13 checks passed
@natasha-moore-elastic
natasha-moore-elastic deleted the nsolomon/alertzero-scaffolding branch October 12, 2026 10:03
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