Repository navigation
Point 8.x prebuilt rule pages to the 9.x prebuilt rules reference - #3368
Draft
nastasha-solomon wants to merge 1 commit into
Draft
nastasha-solomon wants to merge 1 commit into
nastasha-solomon wants to merge 1 commit into
Conversation
The "latest documentation" banner on the 8.x Security prebuilt rule reference and downloadable rule update pages sent readers to /docs. Map both hub pages to /docs/reference/security/prebuilt-rules. Versioned rule pages (prebuilt-rule-<x>-<y>-<z>-<rule>.html) now use the rule's existing mapping when it has one, and otherwise fall back to the prebuilt rules reference instead of /docs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
A documentation preview will be available soon. Request a new doc build by commenting
If your PR continues to fail for an unknown reason, the doc build pipeline may be broken. Elastic employees can check the pipeline status here. |
nastasha-solomon
marked this pull request as draft
November 4, 2026 19:34
This branch has not been deployed
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.
Relates to https://github.com/elastic/docs-content-internal/issues/750
The "latest documentation" banner on the 8.x Elastic Security prebuilt rule pages links to the docs homepage (
/docs) instead of the Prebuilt detection rules reference. This PR fixes that in two parts.v3-mapping.json: maps the two hub pages to the prebuilt rules reference:prebuilt-rules.html(Prebuilt rule reference)prebuilt-rules-downloadable-updates.html(Downloadable rule updates)url_to_v3.rb: adds a fallback for the versioned changelog pages (prebuilt-rule-<x>-<y>-<z>-<rule>.html). There are dozens of summary pages and one page per rule per release, so listing them one by one isn't practical. For these pages, the banner now:/en/security/*/<rule>.html), if it has one, to link to that rule's 9.x page.Exact mappings still take priority, and pages in other books aren't affected.
Testing
I ran
UrlToV3against the updated mapping, using a stub doc with an/en/security/8.19outdir:prebuilt-rules.html/docs/reference/security/prebuilt-rulesprebuilt-rules-downloadable-updates.html/docs/reference/security/prebuilt-rulesprebuilt-rule-8-19-14-prebuilt-rules-8-19-14-summary.html/docs/reference/security/prebuilt-rulesprebuilt-rule-8-17-1-a-scheduled-task-was-created.html/docs/reference/security/prebuilt-rules/rules/windows/persistence_scheduled_task_creation_winlogprebuilt-rule-8-19-14-potential-sap-netweaver-exploitation.html(rule not mapped yet)/docs/reference/security/prebuilt-rulesprebuilt-rules-api.html(existing entry)/docs(unchanged)prebuilt-rule-8-19-14-foo.htmlin the Kibana book/docs(unchanged)I didn't run
make check(rspec and rubocop) locally because Docker wasn't available, so I'm relying on CI for those.This doesn't address the other direction raised in the issue: linking from the 9.x reference back to older 8.x versions.
🤖 Generated with Claude Code