Repository navigation
feat(platform): give Certificate Manager and Custom Pages their own sections and rework Workloads - #2659
Merged
Conversation
…n sections
Certificate Manager and Custom Pages leave Workloads and become Platform
Resource sections at /platform/certificate-manager/ and
/platform/custom-pages/, with their own nav trees registered after
Workloads in the root menu.
- Move the existing pages to the new permalinks (EN and PT) and retarget
their internal links; namespaces unchanged.
- Add Overview, How it works, Guides and tutorials, Limits,
Troubleshooting and Glossary to both sections, and Best practices to
Certificate Manager, with facts from the current Workloads pages.
- Replace the two root hubs with the Overviews.
- Remove both rows from workloads.json; DDoS Protection stays.
- Redirect every old permalink in redirects/{en,pt-br}/01.json and
rechain the rows that pointed at the old URLs.
…inbound links Apply the review findings to every page of both sections, rebuild Error Responses in the Reference shape, and point inbound links at the new pages. Links to the retired Workloads DDoS Protection anchor now go to Attack mitigation, Terms of Service included. Both trees now follow AI Inference in the root menu.
Rebuild the Overview in the current shape, add Scope to Limits, and remove the Certificate Manager and Custom Pages sections and glossary rows, which now live in their own sections. Attack mitigation carries the DDoS Protection facts the Overview no longer states.
marcus-souza-azion
requested review from
a team and
bruno-andrade-azion
as code owners
November 18, 2026 00:09
8 of 14 tasks
Rewrite the URLs that still pointed at the retired Workloads paths and anchors for Certificate Manager and Custom Pages, URL only.
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: none
Pages affected:
/en/documentation/platform/certificate-manager/**and/en/documentation/platform/custom-pages/**(new sections, PT/pt-br/documentacao/plataforma/...),/en/documentation/platform/workloads/**(Overview, How it works, Limits, Best practices, Troubleshooting, Glossary, Quickstart, Settings, Attack mitigation, DDoS Protection hub), plus inbound links in about 80 pages across get started, guides, devtools, architectures, use cases, pricing, release notes and both Terms of Service versions.Certificate Manager and Custom Pages become standalone Platform Resources. They leave Workloads and get their own sections, registered in the root menu right after AI Inference.
/platform/workloads/certificate-manager/and/platform/workloads/custom-pages/to/platform/certificate-manager/and/platform/custom-pages/, keeping their namespaces. Error Responses moves from the Applications reference into Custom Pages.## Scope, Troubleshooting, Glossary, and a guides hub; Best practices for Certificate Manager only, because no source carries Custom Pages practices.Workloads is rewritten to the current style guide.
## Request path, and router.## Scope.Links.
#ddos-protection. 59 links to it now point at Attack mitigation (/workloads/ddos-protection/ddos-mitigation/), Terms of Service included. In both ToS versions, only the URL changed, with legal sign-off.How I checked it.
docs_gate.py --check --cross: no P0 on the changed pages.pnpm lint:codeblockson the 156 changed pages: no issues.npx prettier --checkon every changed file: clean.pnpm lint:navcheck: passes. The 50 warnings are the soft row maximum and were already there.pnpm lint:slugcheck: fails on the same 3 pt-br files as onmain(ANPD and an old ToS page), and nothing new.pnpm build:local. The pages are the source of truth, so no fact was rechecked against the live API or Console.Open items, not in this PR:
src/nav/topnav.jsonhas no entry for the two new trees.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— every page carries the first five;last_reviewedis on no page in the corpusapps/docs/redirects/en/01.jsonandapps/docs/redirects/pt-br/01.json, every old Certificate Manager and Custom Pages URL to its new URLpt-brupdated in this PR or follow-upi18nissue created: every page is changed in both languagespnpm build:local(build + frontmatter check) without errors — not run; the reviewer runs the build