Repository navigation
docs(firewall): retire the WAF and Bot Manager examples hubs - #2656
Merged
Merged
Conversation
The Examples slot is for Functions only; the 12 examples are already how-to guides listed by the Firewall guides and tutorials hub. Remove the en and pt-br hubs, their discarded entries in src/nav/redirects.json, and redirect the four URLs to the Firewall guides hub. Co-Authored-By: Claude <[email protected]>
bruno-andrade-azion
requested review from
a team and
marcus-souza-azion
as code owners
November 17, 2026 15:05
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.
What & why
Related issue: MM-16268
Pages affected:
/en/documentation/secure/waf/examples/,/en/documentation/secure/bot-manager/examples/,/pt-br/documentacao/secure/waf/exemplos/,/pt-br/documentacao/secure/bot-manager/exemplos/(all four removed)Retires the WAF and Bot Manager examples hubs instead of moving them. The ticket asked to move the two hubs from
/documentation/secure/...to/documentation/platform/firewall/...and register them infirewall.json. The Information architecture page rules that target out: the Examples slot is for Functions only, and a worked configuration for any other Platform Resource is a how-to guide in the Guides catalog, listed by the resource's Guides and tutorials hub. A nested Product such as WAF or Bot Manager has no Examples row of its own either. The 12 example pages behind the two hubs already are how-to guides: they arehow-to-guiderows insrc/nav/trees/guides.json, and the Firewall guides and tutorials hub lists them. Registering the hubs would add a second list of a subset of those rows, in a slot the style guide does not allow.Navigation and redirects. #2593 parked both hubs in
src/nav/redirects.jsonas discarded, pointing at the Firewall guides and tutorials hub, and left the two entries for this ticket. This PR deletes the four page files, removes the two entries, and adds the four 301s thatpnpm nav:url-mapgenerated from them. No other page links to the old URLs, and no existing redirect points at them, so there is no chain to retarget.Out of scope. The 12 child files still sit under
secure/{waf,bot-manager}/examples/(exemplos/) while their permalinks are under/documentation/guides/application-security/.... The path does not decide the URL, so the files stay where they are. The six/documentation/products/secure/journey pages from the same review finding are not in this ticket.How I checked it.
pnpm lint:navcheck: passes, 0 discarded, 3 exempt, no orphans.pnpm lint:slugcheck: the 3 known failures of the single-language legal pages, the same asmain.pnpm lint:links: no finding on the changed paths.azion-docs-writerskill'slinkcheck.pyover the 926secure,guides, andhubspages: 0 broken links, 0 unpaired namespaces.git grepfor the four old URLs and the two namespaces: no remaining references outside the redirect files.pnpm build:local(Node 26): 2162 pages built, the frontmatter check passed. Indist, the four old URLs are gone, and both Firewall guides and tutorials hubs list all 12 former example guides.Type of change
feat)fix) — typo, broken link, wrong informationdocs) — rewrite, expansion, upkeepi18n)refactor/chore) — reviewed by UXE, no content mixed inAuthor checklist
type(scope): summary(see GOVERNANCE.md §4)title,description,meta_tags,namespace,permalink,last_reviewed— no page is added or edited, only removed/en/documentation/secure/waf/examples/->/en/documentation/platform/firewall/guides/(apps/docs/redirects/en/01.json)/en/documentation/secure/bot-manager/examples/->/en/documentation/platform/firewall/guides/(apps/docs/redirects/en/01.json)/pt-br/documentacao/secure/waf/exemplos/->/pt-br/documentacao/plataforma/firewall/guias/(apps/docs/redirects/pt-br/01.json)/pt-br/documentacao/secure/bot-manager/exemplos/->/pt-br/documentacao/plataforma/firewall/guias/(apps/docs/redirects/pt-br/01.json)pt-brupdated in this PR or follow-upi18nissue created: — both pt-br hubs are removed and redirected in this PRpnpm build:local(build + frontmatter check) without errors