docs(nav): triage the pages outside the navigation by bruno-andrade-azion · Pull Request #2593 · aziontech/docs

bruno-andrade-azion · 2026-11-05T21:20:19Z

Summary

Triages the 105 English pages that sit in no navigation tree (MM-16244). All 105 already passed lint:navcheck on main: 100 were parked in src/nav/redirects.json as "discarded" and 5 in src/nav/exempt.json. This PR checks each parking and finishes it.
Retires 63 pages (en + pt-br, 126 files). 62 of them already had a redirect row, but their sources stayed in the repo: the old Build, Deliver, Observe, Secure, and Platform homes, the five by-solution architecture landings, the develop-with-azion pages, the Store and Observe journey pages (MM-16240), the 35 template-showcase landings (MM-16247), Form Builder, peering, and the templates-and-integrations overview. Production answers 301 for 123 of their 124 URLs today. The exception is the pt-br Nextal landing, which kept the English path /pt-br/documentation/products/templates/nextal/: production does not run the pt-br redirects under /pt-br/documentation/, so that URL answers 200 today and 404 once this PR deploys. The 63rd page, the legacy How to create a digital certificate guide, was live. It now 301s to Upload a digital certificate. That guide gains a Bind the certificate to a v3 domain section (Console + API v3), so the v3 steps the old guide carried are not lost, and the VersionDualSteps notice, since the guide now has steps for API v4 and API v3. The PR also deletes the 64 images that only these pages used (about 24 MB).
Keeps the 19 Reference Architecture pages and places them in the Use Cases tree. src/nav/redirects.json marked them "folded into its use-case page", but they were never redirected, and the use-case catalog (gtm-definitions/use-cases.md) lists each one as the Docs of a Reference Architecture (Published or Needs update). docs(architectures): keep security-modernization and bot-management as API v3 versions #2589 also keeps WAAP and Online Fraud Prevention as the v4 pages for its v3 versions. Each page gets a "hidden": true row next to its use case, in that use case's Solution group. The page keeps its URL, sidebar context, and breadcrumb, and it stays out of the menu, the hub, and prev/next. Removing the "discarded" entries also means pnpm nav:url-map can no longer turn these live pages into 301s.

How to test

cd apps/docs && pnpm lint:navcheck. Expect: passes, 18 discarded, 5 exempt. Hidden rows still count toward the soft max of 7 children, so the architectures groups print soft-max warnings (warnings only).
pnpm nav:migrate (dry run). Expect: 0 page/language permalinks to move.
pnpm build:local (Node 26; NODE_USE_SYSTEM_CA=1 behind a TLS-intercepting proxy). Expect: Complete!.
Open /en/documentation/use-cases/build-and-run-applications/microservices-applications/. The breadcrumb reads Use Cases > Build and run applications > Microservices API on Functions, the sidebar opens on that group, and the page is not a menu row. Repeat with the pt-br twin /pt-br/documentacao/casos-de-uso/construir-e-executar-aplicacoes/aplicacoes-microsservicos/.
Open /en/documentation/guides/application-security/tls-and-certificates/digital-certificates/#bind-the-certificate-to-a-v3-domain and the pt-br /pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/certificado-digital/#vincule-o-certificado-a-um-dominio-v3. The intro's v3 sentence links to this section.
node scripts/ci/ratchet.mjs linkcheck and node scripts/ci/ratchet.mjs slugcheck from the repo root, after the build.

URL changes and redirects

Removed permalinks:

121 URLs keep the redirect row they already had in apps/docs/redirects/{en,pt-br}/0[01].json, and production answers that 301 today, in one hop to a live page.
/en/documentation/products/azion-network-program/ and /pt-br/documentacao/produtos/azion-network-program/ keep their row with a new target (see Retargeted).
/pt-br/documentation/products/templates/nextal/ has a row in redirects/pt-br/01.json that never fires, because production runs the pt-br redirects only under /pt-br/documentacao/. The URL answers 200 today and 404 after this PR. The rule lives in the production application's Rules Engine, not in this repo (follow-up below).
/en/documentation/guides/application-security/tls-and-certificates/create-a-digital-certificate/ -> /en/documentation/guides/application-security/tls-and-certificates/digital-certificates/ (added, redirects/en/01.json)
/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/criar-certificado-digital/ -> /pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/certificado-digital/ (added, redirects/pt-br/01.json)

The 126 removed permalinks, one per line

en

/en/documentation/architectures/by-solution/application-and-infrastructure-automation/ -> /en/documentation/use-cases/ (redirects/en/01.json)
/en/documentation/architectures/by-solution/application-and-network-security/ -> /en/documentation/use-cases/ (redirects/en/01.json)
/en/documentation/architectures/by-solution/application-development/ -> /en/documentation/use-cases/ (redirects/en/01.json)
/en/documentation/architectures/by-solution/artificial-intelligence/ -> /en/documentation/use-cases/ (redirects/en/01.json)
/en/documentation/architectures/by-solution/service-performance-and-reliability/ -> /en/documentation/use-cases/ (redirects/en/01.json)
/en/documentation/devtools/form-builder/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/guides/application-security/tls-and-certificates/create-a-digital-certificate/ -> /en/documentation/guides/application-security/tls-and-certificates/digital-certificates/ (redirects/en/01.json, added in this PR)
/en/documentation/platform/marketplace/templates-and-integrations-overview/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/accounts/ -> /en/documentation/fundamentals/ (redirects/en/01.json)
/en/documentation/products/azion-network-program/ -> /en/documentation/support/#other-contacts (redirects/en/01.json, retargeted in this PR)
/en/documentation/products/build/ -> /en/documentation/ (redirects/en/01.json)
/en/documentation/products/build/develop-with-azion/cli/ -> /en/documentation/devtools/cli/ (redirects/en/01.json)
/en/documentation/products/build/develop-with-azion/code-editor/ -> /en/documentation/platform/functions/code-editor/ (redirects/en/01.json)
/en/documentation/products/build/develop-with-azion/environment-variables/ -> /en/documentation/platform/functions/environment-variables/ (redirects/en/01.json)
/en/documentation/products/build/develop-with-azion/frameworks-specific/overview/ -> /en/documentation/guides/ (redirects/en/01.json)
/en/documentation/products/build/develop-with-azion/language-specific/javascript/ -> /en/documentation/guides/application-development/functions-and-runtime/first-steps/ (redirects/en/01.json)
/en/documentation/products/build/develop-with-azion/language-specific/wasm/ -> /en/documentation/guides/application-development/functions-and-runtime/webassembly-on-azion-platform/ (redirects/en/01.json)
/en/documentation/products/build/develop-with-azion/local-dev/ -> /en/documentation/platform/functions/local-development/ (redirects/en/01.json)
/en/documentation/products/build/develop-with-azion/runtime-apis/ -> /en/documentation/devtools/runtime/ (redirects/en/01.json)
/en/documentation/products/build/develop-with-azion/terraform-provider/ -> /en/documentation/devtools/terraform/ (redirects/en/01.json)
/en/documentation/products/deploy/ -> /en/documentation/ (redirects/en/01.json)
/en/documentation/products/guides/build/overview/ -> /en/documentation/guides/ (redirects/en/01.json)
/en/documentation/products/observe/ -> /en/documentation/ (redirects/en/01.json)
/en/documentation/products/observe/analyze-logs/ -> /en/documentation/platform/real-time-events/ (redirects/en/01.json)
/en/documentation/products/observe/monitor-applications/ -> /en/documentation/platform/real-time-metrics/ (redirects/en/01.json)
/en/documentation/products/observe/overview/ -> /en/documentation/platform/real-time-metrics/ (redirects/en/01.json)
/en/documentation/products/secure/ -> /en/documentation/ (redirects/en/01.json)
/en/documentation/products/store/overview/ -> /en/documentation/ (redirects/en/01.json)
/en/documentation/products/templates/angular-boilerplate/ -> /en/documentation/guides/application-development/frameworks/angular-boilerplate/ (redirects/en/01.json)
/en/documentation/products/templates/angular-buttercms/ -> /en/documentation/guides/application-development/frameworks/butter-templates-collection/ (redirects/en/01.json)
/en/documentation/products/templates/astro-audiophile/ -> /en/documentation/guides/application-development/frameworks/astro-ecommerce-collection/ (redirects/en/01.json)
/en/documentation/products/templates/astro-blog-starter-kit/ -> /en/documentation/guides/application-development/frameworks/astro-blog-starter-kit/ (redirects/en/01.json)
/en/documentation/products/templates/astro-boilerplate/ -> /en/documentation/guides/application-development/frameworks/astro-boilerplate/ (redirects/en/01.json)
/en/documentation/products/templates/astro-cosmic-blog/ -> /en/documentation/guides/application-development/frameworks/cosmic-simple-astro-blog/ (redirects/en/01.json)
/en/documentation/products/templates/astro-devscard/ -> /en/documentation/guides/application-development/frameworks/devscard/ (redirects/en/01.json)
/en/documentation/products/templates/astro-ecommerce/ -> /en/documentation/guides/application-development/frameworks/astro-ecommerce-collection/ (redirects/en/01.json)
/en/documentation/products/templates/astro-markdoc/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-markdown-with-plugins/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-markdown-with-shiki/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-mdx/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-minimal/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-multiple-frameworks/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-nanostores/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-non-html/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-pdf-resume/ -> /en/documentation/guides/application-development/frameworks/webpage-to-pdf-resume/ (redirects/en/01.json)
/en/documentation/products/templates/astro-portfolio/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-preact/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-quickstore/ -> /en/documentation/guides/application-development/frameworks/astro-ecommerce-collection/ (redirects/en/01.json)
/en/documentation/products/templates/astro-sanity/ -> /en/documentation/guides/application-development/frameworks/clean-astro-sanity/ (redirects/en/01.json)
/en/documentation/products/templates/astro-starlog/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-tailwind/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/astro-vitest/ -> /en/documentation/platform/marketplace/ (redirects/en/01.json)
/en/documentation/products/templates/cosmic-agency/ -> /en/documentation/guides/application-development/frameworks/cosmic-agency-website/ (redirects/en/01.json)
/en/documentation/products/templates/cosmic-nextjs-blog/ -> /en/documentation/guides/application-development/frameworks/cosmic-simple-next-blog/ (redirects/en/01.json)
/en/documentation/products/templates/gatsby-blog/ -> /en/documentation/guides/application-development/frameworks/gatsby-blog-starter-kit/ (redirects/en/01.json)
/en/documentation/products/templates/gatsby-boilerplate/ -> /en/documentation/guides/application-development/frameworks/gatsby-boilerplate/ (redirects/en/01.json)
/en/documentation/products/templates/gatsby-butter-starter/ -> /en/documentation/guides/application-development/frameworks/butter-templates-collection/ (redirects/en/01.json)
/en/documentation/products/templates/gatsby-ecommerce/ -> /en/documentation/guides/application-development/frameworks/gatsby-ecommerce-theme/ (redirects/en/01.json)
/en/documentation/products/templates/nextal/ -> /en/documentation/guides/application-development/frameworks/nextal/ (redirects/en/01.json)
/en/documentation/products/templates/nextjs-static-boilerplate/ -> /en/documentation/guides/application-development/frameworks/nextjs-static-boilerplate/ (redirects/en/01.json)
/en/documentation/products/templates/react-boilerplate/ -> /en/documentation/guides/application-development/frameworks/react-boilerplate/ (redirects/en/01.json)
/en/documentation/products/templates/react-buttercms/ -> /en/documentation/guides/application-development/frameworks/butter-templates-collection/ (redirects/en/01.json)
/en/documentation/products/templates/space-jelly-shop/ -> /en/documentation/guides/application-development/frameworks/next-js-ecommerce-collection/ (redirects/en/01.json)

pt-br

/pt-br/documentacao/arquiteturas/por-solucao/automacao-de-aplicacoes-e-infraestrutura/ -> /pt-br/documentacao/casos-de-uso/ (redirects/pt-br/01.json)
/pt-br/documentacao/arquiteturas/por-solucao/desenvolvimento-de-aplicacoes/ -> /pt-br/documentacao/casos-de-uso/ (redirects/pt-br/01.json)
/pt-br/documentacao/arquiteturas/por-solucao/inteligencia-artificial/ -> /pt-br/documentacao/casos-de-uso/ (redirects/pt-br/01.json)
/pt-br/documentacao/arquiteturas/por-solucao/performance-e-confiabilidade-do-servico/ -> /pt-br/documentacao/casos-de-uso/ (redirects/pt-br/01.json)
/pt-br/documentacao/arquiteturas/por-solucao/seguranca-de-aplicacoes-e-redes/ -> /pt-br/documentacao/casos-de-uso/ (redirects/pt-br/01.json)
/pt-br/documentacao/devtools/form-builder/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/criar-certificado-digital/ -> /pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/certificado-digital/ (redirects/pt-br/01.json, added in this PR)
/pt-br/documentacao/plataforma/marketplace/visao-geral-templates-e-integracoes/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/azion-network-program/ -> /pt-br/documentacao/suporte/#outros-contatos (redirects/pt-br/01.json, retargeted in this PR)
/pt-br/documentacao/produtos/build/ -> /pt-br/documentacao/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/build/desenvolvimento-azion/cli/ -> /pt-br/documentacao/devtools/cli/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/build/desenvolvimento-azion/code-editor/ -> /pt-br/documentacao/plataforma/functions/code-editor/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/build/desenvolvimento-azion/linguagens/wasm/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/functions-e-runtime/webassembly-na-plataforma-azion/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/build/desenvolvimento-azion/local-dev/ -> /pt-br/documentacao/plataforma/functions/local-development/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/build/desenvolvimento-azion/runtime/ -> /pt-br/documentacao/devtools/runtime/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/build/desenvolvimento-azion/terraform-provider/ -> /pt-br/documentacao/devtools/terraform/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/build/develop-with-azion/frameworks-specific/visao-geral/ -> /pt-br/documentacao/guias/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/build/environment-variables/ -> /pt-br/documentacao/plataforma/functions/environment-variables/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/deploy/ -> /pt-br/documentacao/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/desenvolvimento-azion/linguagens/javascript/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/functions-e-runtime/primeiros-passos/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/gestao-de-contas/ -> /pt-br/documentacao/fundamentos/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/guias/build/visao-geral/ -> /pt-br/documentacao/guias/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/observe/ -> /pt-br/documentacao/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/observe/analisar-logs/ -> /pt-br/documentacao/plataforma/real-time-events/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/observe/monitorar-aplicacoes/ -> /pt-br/documentacao/plataforma/real-time-metrics/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/observe/visao-geral/ -> /pt-br/documentacao/plataforma/real-time-metrics/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/secure/ -> /pt-br/documentacao/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/store/visao-geral/ -> /pt-br/documentacao/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/angular-boilerplate/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/angular-boilerplate/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/angular-buttercms/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/butter-templates-collection/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-audiophile/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/astro-ecommerce-collection/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-blog-starter-kit/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/astro-blog-starter-kit/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-boilerplate/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/astro-boilerplate/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-cosmic-blog/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/cosmic-simple-astro-blog/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-devscard/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/devscard/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-ecommerce/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/astro-ecommerce-collection/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-markdoc/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-markdown-with-plugins/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-markdown-with-shiki/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-mdx/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-minimal/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-multiple-frameworks/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-nanostores/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-non-html/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-pdf-resume/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/webpage-to-pdf-resume/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-portfolio/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-preact/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-quickstore/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/astro-ecommerce-collection/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-sanity/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/clean-astro-sanity/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-starlog/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-tailwind/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/astro-vitest/ -> /pt-br/documentacao/plataforma/marketplace/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/cosmic-agency/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/cosmic-agency-website/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/cosmic-nextjs-blog/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/cosmic-simple-next-blog/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/gatsby-blog/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/gatsby-blog-starter-kit/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/gatsby-boilerplate/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/gatsby-boilerplate/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/gatsby-butter-starter/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/butter-templates-collection/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/gatsby-ecommerce/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/gatsby-ecommerce-theme/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/nextjs-static-boilerplate/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/nextjs-static-boilerplate/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/react-boilerplate/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/react-boilerplate/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/react-buttercms/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/butter-templates-collection/ (redirects/pt-br/01.json)
/pt-br/documentacao/produtos/templates/space-jelly-shop/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/next-js-ecommerce-collection/ (redirects/pt-br/01.json)
/pt-br/documentation/products/templates/nextal/ -> /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/nextal/ (redirects/pt-br/01.json, never fires: production answers 200 today, 404 after this PR)

Retargeted, so no reader goes through a chain or lands on an unrelated page:

/products/deliver/ (en + pt-br, 00.json) pointed at the retired /products/deploy/ and now goes straight to the docs home.
/products/peering/, /docs/products/peering/ and /products/azion-network-program/ (en + pt-br, 00.json and 01.json, 10 rows) pointed at Professional Services, which has no peering content. They now point to the support contacts table, which lists the peering and NOC addresses: /en/documentation/support/#other-contacts and /pt-br/documentacao/suporte/#outros-contatos.

No URL of a kept page changes. The 19 architecture pages keep theirs, as nav:migrate confirms.

Notes

Where the other orphans went: 18 entries stay in src/nav/redirects.json for their owners: 7 for docs(platform): retire the v3 build and deploy journey pages #2587 (MM-16238), 8 for docs(secure): retire the pre-Workloads security journey and guide pages #2586 (MM-16239), 2 for MM-16268 (the WAF and Bot Manager example hubs, to be registered in firewall.json), and liveness-detection for docs(templates): point Deploy links to the current Marketplace catalog (MM-16236) #2582 (MM-16236), which already deletes it. 5 entries stay in exempt.json: the 2 architectures docs(architectures): keep security-modernization and bot-management as API v3 versions #2589 (MM-16243) keeps as v3 versions, coming-soon (resolve.ts uses it as a constant), and the 2 Orchestrator architectures (no catalogued use case).
Merge conflicts to expect:
- src/nav/redirects.json with docs(secure): retire the pre-Workloads security journey and guide pages #2586, docs(platform): retire the v3 build and deploy journey pages #2587, and docs(templates): point Deploy links to the current Marketplace catalog (MM-16236) #2582. Apply both sides' removals.
- The end of redirects/{en,pt-br}/01.json with docs(secure): retire the pre-Workloads security journey and guide pages #2586, docs(platform): retire the v3 build and deploy journey pages #2587, and docs(architectures): keep security-modernization and bot-management as API v3 versions #2589. Keep both appended blocks.
- docs(architectures): keep security-modernization and bot-management as API v3 versions #2589 edits the two by-solution security hubs that this PR deletes. Keep the deletion: their URLs already 301 to /use-cases/.
Schema comment: the hidden comment in src/nav/schema.ts now covers Reference Architecture pages. An earlier revision also changed scripts/lint-navcheck.ts to count only visible children for the soft max. That change is reverted, because content and code changes don't travel together, and it is listed as a follow-up.
Follow-ups (not in this PR):
- Link each Reference Architecture page from its use-case page: docs(use-cases): link each Reference Architecture page from its use case #2594, stacked on this PR.
- Count only visible rows toward the navcheck soft max (chore(nav), separate PR).
- Make the pt-br Massive Redirect run under /pt-br/documentation/ too, in the production Rules Engine. Until then, every pt-br row with an English path is dead.
- Update the catalog's "Docs:" lines and rewrite the 12 pages it marks "Needs update".
- Confirm with the Functions and Marketplace owners whether Form Builder still ships. Its only page was already 301'd to the Marketplace hub.
- ai_agent_autonomous_security keeps its URL under Build and run AI workloads, while the catalog files it under Secure applications and networks.
- AGENTS.md still gives pnpm -F redirects-massive test as its example of running another app's script, and that app no longer exists.
Review pass (2026-11-11): merged main (no conflicts) and applied the review against the style guide as of this PR's base: the VersionDualSteps notice and the v3 section reworked to the procedure and sentence rules, the navcheck change reverted, and no ticket code in the title. A curl of all 126 removed URLs in production returned 301 for 123 (the 2 certificate URLs are still live, and the pt-br Nextal URL is described above).
Checks run locally on the merged tree: build:local passes (2,178 pages). lint:navcheck passes. nav:migrate reports 0 moves. ci:ratchet linkcheck reports 165 issues (baseline 221), and none of them involves a URL in this diff. ci:ratchet slugcheck reports 6 (baseline 6). docs_gate and linkcheck.py report 0 findings on the edited pages.
Jira: MM-16244 · Epic MM-16212

Retire 63 orphan pages in en and pt-br. 62 already 301 in production and only their sources were left; the legacy create-a-digital-certificate guide now 301s to Upload a digital certificate, which gains a section to bind the certificate to a v3 domain. Delete the 64 images only those pages used. Keep the 19 Reference Architecture pages that src/nav/redirects.json marked as folded: register each as a hidden row beside its use case in the Use Cases tree, so it keeps its URL, sidebar context and breadcrumb. Rechain the deliver and peering redirects, and point the peering URLs to the support contacts. navcheck now counts only visible children for its soft max.

…-main * origin/main: (21 commits) feat(nav): give every breadcrumb crumb a page and make CLI commands runnable (#2636) fix(cli): drop azion update workload-deployment, which the CLI does not expose (#2639) docs(terminology): retire Edge Node, module, and add-on from current pages (#2618) docs(migration): share the repeated migration-guide procedures as partials (#2619) fix(marketplace): drop the Azion CLI prerequisite from firewall integration guides (#2612) docs(guides): replace the residual "These checks confirm" lines with use-case expect blocks (#2611) docs(guides): make the auth layer and vector search tutorials runnable (#2566) chore(scripts): add pnpm lint:terraform to validate Terraform samples (#2637) fix(firewall): correct the CLI binding, the WAF config sample, and the JWT paywall steps (#2565) docs(cli): document azion workload-deployment and fix pages that say the CLI cannot bind a deployment (#2567) docs(terraform): rewrite the samples for provider v2.10.0 (#2557) chore(deploy): promote docs-v2.4.4 to production (#2631) chore(main): release docs 2.4.4 (#2627) chore(deploy): promote docs-v2.4.3 to production (#2617) fix(applications): apply live test results and define each resource by its role (#2626) chore(main): release docs 2.4.3 (#2616) docs(applications): review the Applications section and apply the updated writing rules (#2615) chore(deps): bump npm and GitHub Actions dependencies (#2590) chore(deploy): promote docs-v2.4.2 to production (#2610) chore(main): release docs 2.4.2 (#2609) ...

Add the VersionDualSteps notice to Upload a digital certificate (en and pt-br), now that the guide carries API v4 and API v3 steps, and rework the v3 section to the style guide: sentences within the cap, the three shared tasks as a list, the canonical Console first step, an outcome sentence, an API lead-in that ends in a colon, the GET output, and link text that matches the target title. Revert the navcheck soft-max change, which is a code change and goes in its own pull request.

…ase (#2594) Co-authored-by: Bruno Germano <bruno.germano@gmail.com>

* origin/main: (24 commits) chore(nav): count only visible rows toward the navcheck soft max (#2640) docs(nav): triage the pages outside the navigation (#2593) fix(guides): match the QStash variable and the Functions usage response to the code (#2571) feat(nav): give every breadcrumb crumb a page and make CLI commands runnable (#2636) fix(cli): drop azion update workload-deployment, which the CLI does not expose (#2639) docs(terminology): retire Edge Node, module, and add-on from current pages (#2618) docs(migration): share the repeated migration-guide procedures as partials (#2619) fix(marketplace): drop the Azion CLI prerequisite from firewall integration guides (#2612) docs(guides): replace the residual "These checks confirm" lines with use-case expect blocks (#2611) docs(guides): make the auth layer and vector search tutorials runnable (#2566) chore(scripts): add pnpm lint:terraform to validate Terraform samples (#2637) fix(firewall): correct the CLI binding, the WAF config sample, and the JWT paywall steps (#2565) docs(cli): document azion workload-deployment and fix pages that say the CLI cannot bind a deployment (#2567) docs(terraform): rewrite the samples for provider v2.10.0 (#2557) chore(deploy): promote docs-v2.4.4 to production (#2631) chore(main): release docs 2.4.4 (#2627) chore(deploy): promote docs-v2.4.3 to production (#2617) fix(applications): apply live test results and define each resource by its role (#2626) chore(main): release docs 2.4.3 (#2616) docs(applications): review the Applications section and apply the updated writing rules (#2615) ...

…y-filter-removal * origin/main: (24 commits) chore(nav): count only visible rows toward the navcheck soft max (#2640) docs(nav): triage the pages outside the navigation (#2593) fix(guides): match the QStash variable and the Functions usage response to the code (#2571) feat(nav): give every breadcrumb crumb a page and make CLI commands runnable (#2636) fix(cli): drop azion update workload-deployment, which the CLI does not expose (#2639) docs(terminology): retire Edge Node, module, and add-on from current pages (#2618) docs(migration): share the repeated migration-guide procedures as partials (#2619) fix(marketplace): drop the Azion CLI prerequisite from firewall integration guides (#2612) docs(guides): replace the residual "These checks confirm" lines with use-case expect blocks (#2611) docs(guides): make the auth layer and vector search tutorials runnable (#2566) chore(scripts): add pnpm lint:terraform to validate Terraform samples (#2637) fix(firewall): correct the CLI binding, the WAF config sample, and the JWT paywall steps (#2565) docs(cli): document azion workload-deployment and fix pages that say the CLI cannot bind a deployment (#2567) docs(terraform): rewrite the samples for provider v2.10.0 (#2557) chore(deploy): promote docs-v2.4.4 to production (#2631) chore(main): release docs 2.4.4 (#2627) chore(deploy): promote docs-v2.4.3 to production (#2617) fix(applications): apply live test results and define each resource by its role (#2626) chore(main): release docs 2.4.3 (#2616) docs(applications): review the Applications section and apply the updated writing rules (#2615) ...

* origin/main: (29 commits) fix(structure): tag bare code fences, fix heading skips, add pt-br meta_tags (#2629) docs(style-guide): drop the nonexistent GlossaryFilter from the glossary template (#2577) docs(release-notes): fix the October 14 anchor and merge the duplicate February 24 entry (#2572) fix(orchestrator): fix broken bind and create-service API samples (#2574) docs(readability): split the long sentences in the Runtime, CLI, Reference, and KV Store pages (#2635) chore(nav): count only visible rows toward the navcheck soft max (#2640) docs(nav): triage the pages outside the navigation (#2593) fix(guides): match the QStash variable and the Functions usage response to the code (#2571) feat(nav): give every breadcrumb crumb a page and make CLI commands runnable (#2636) fix(cli): drop azion update workload-deployment, which the CLI does not expose (#2639) docs(terminology): retire Edge Node, module, and add-on from current pages (#2618) docs(migration): share the repeated migration-guide procedures as partials (#2619) fix(marketplace): drop the Azion CLI prerequisite from firewall integration guides (#2612) docs(guides): replace the residual "These checks confirm" lines with use-case expect blocks (#2611) docs(guides): make the auth layer and vector search tutorials runnable (#2566) chore(scripts): add pnpm lint:terraform to validate Terraform samples (#2637) fix(firewall): correct the CLI binding, the WAF config sample, and the JWT paywall steps (#2565) docs(cli): document azion workload-deployment and fix pages that say the CLI cannot bind a deployment (#2567) docs(terraform): rewrite the samples for provider v2.10.0 (#2557) chore(deploy): promote docs-v2.4.4 to production (#2631) ... # Conflicts: # apps/docs/src/content/docs/en/pages/observe/real-time-events/data-sources.mdx # apps/docs/src/content/docs/pt-br/pages/observe/real-time-events/fontes-de-dados.mdx

* origin/main: (39 commits) fix(terminology): replace desempenho and aplicativo in pt-br pages (#2621) docs(observe): fix dataset name, Data Stream filter, and Grafana Data path (#2573) fix(fundamentals): rewrite the Load Balancer steps in minimize-downtime from the reference (#2578) i18n(pt-br): label unlabelled asides and fix label casing (#2622) fix(links): point pt-br links to their existing pt-br pages (#2620) i18n(pt-br): resync the drifted release notes, punctuation, and Edge Services pairs (#2624) i18n(pt-br): pair three pages with their English versions by namespace (#2625) docs(style-guide): adopt the jsonl tag for JSON Lines samples (#2642) chore(lint): check the changelog entries a PR adds (#2634) [NO-ISSUE] ci: replace technote-space/assign-author (SO-5131) (#2591) fix(structure): tag bare code fences, fix heading skips, add pt-br meta_tags (#2629) docs(style-guide): drop the nonexistent GlossaryFilter from the glossary template (#2577) docs(release-notes): fix the October 14 anchor and merge the duplicate February 24 entry (#2572) fix(orchestrator): fix broken bind and create-service API samples (#2574) docs(readability): split the long sentences in the Runtime, CLI, Reference, and KV Store pages (#2635) chore(nav): count only visible rows toward the navcheck soft max (#2640) docs(nav): triage the pages outside the navigation (#2593) fix(guides): match the QStash variable and the Functions usage response to the code (#2571) feat(nav): give every breadcrumb crumb a page and make CLI commands runnable (#2636) fix(cli): drop azion update workload-deployment, which the CLI does not expose (#2639) ... # Conflicts: # apps/docs/src/content/docs/en/pages/store/sql-database/glossary.mdx # apps/docs/src/content/docs/pt-br/pages/store/sql-database/glossario.mdx

* origin/main: (53 commits) docs(style-guide): standardize Azion Console click paths (#2596) docs(store): name the SQL and Storage libraries by their scoped packages (#2575) fix(terminology): replace desempenho and aplicativo in pt-br pages (#2621) docs(observe): fix dataset name, Data Stream filter, and Grafana Data path (#2573) fix(fundamentals): rewrite the Load Balancer steps in minimize-downtime from the reference (#2578) i18n(pt-br): label unlabelled asides and fix label casing (#2622) fix(links): point pt-br links to their existing pt-br pages (#2620) i18n(pt-br): resync the drifted release notes, punctuation, and Edge Services pairs (#2624) i18n(pt-br): pair three pages with their English versions by namespace (#2625) docs(style-guide): adopt the jsonl tag for JSON Lines samples (#2642) chore(lint): check the changelog entries a PR adds (#2634) [NO-ISSUE] ci: replace technote-space/assign-author (SO-5131) (#2591) fix(structure): tag bare code fences, fix heading skips, add pt-br meta_tags (#2629) docs(style-guide): drop the nonexistent GlossaryFilter from the glossary template (#2577) docs(release-notes): fix the October 14 anchor and merge the duplicate February 24 entry (#2572) fix(orchestrator): fix broken bind and create-service API samples (#2574) docs(readability): split the long sentences in the Runtime, CLI, Reference, and KV Store pages (#2635) chore(nav): count only visible rows toward the navcheck soft max (#2640) docs(nav): triage the pages outside the navigation (#2593) fix(guides): match the QStash variable and the Functions usage response to the code (#2571) ... # Conflicts: # apps/docs/src/content/docs/en/pages/main-menu/reference/accounts/personal-tokens.mdx # apps/docs/src/content/docs/en/pages/main-menu/reference/services/support/http-error-status-codes.mdx # apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/contas/personal-tokens.mdx

bruno-andrade-azion requested a review from a team November 5, 2026 21:20

bruno-andrade-azion requested review from a team and marcus-souza-azion as code owners November 5, 2026 21:20

github-actions Bot assigned bruno-andrade-azion Nov 5, 2026

bruno-andrade-azion changed the title ~~docs(nav): triage the pages outside the navigation (MM-16244)~~ docs(nav): triage the pages outside the navigation Nov 11, 2026

bruno-andrade-azion mentioned this pull request Nov 12, 2026

chore(nav): count only visible rows toward the navcheck soft max #2640

Merged

9 of 14 tasks

docs(use-cases): link each Reference Architecture page from its use c…

8b248ac

…ase (#2594) Co-authored-by: Bruno Germano <bruno.germano@gmail.com>

bruno-andrade-azion merged commit cf7f0d2 into main Nov 12, 2026
9 checks passed

bruno-andrade-azion deleted the docs/mm-16244-triage-orphan-pages branch November 12, 2026 13:08

github-actions Bot mentioned this pull request Nov 12, 2026

chore(main): release docs 2.5.0 #2638

Open

marcus-souza-azion mentioned this pull request Nov 12, 2026

docs(style-guide): standardize Azion Console click paths #2596

Merged

8 of 14 tasks

Navigation Menu

Repository navigation

docs(nav): triage the pages outside the navigation - #2593

docs(nav): triage the pages outside the navigation#2593
bruno-andrade-azion merged 4 commits into
mainfrom
docs/mm-16244-triage-orphan-pages

bruno-andrade-azion commented Nov 5, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Milestone

Development

Uh oh!

2 participants

Conversation

bruno-andrade-azion commented Nov 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

How to test

URL changes and redirects

Notes

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Milestone

Development

Uh oh!

2 participants

bruno-andrade-azion commented Nov 5, 2026 •

edited

Loading