[bruno-andrade-azion]

What & why

Related issue: MM-16255
Pages affected: 10 pt-br pages under apps/docs/src/content/docs/pt-br/pages/ and 2 pt snippets under apps/docs/src/includes/snippets/:
arquiteturas/orch/application-deliver-automation.mdx, deploy-jornada/avancado/desinstalar-node/desinstalar-node.mdx, deploy-jornada/configurar-node/instalar-orch-agent/instalar-orch-agent.mdx, guias/troubleshooting/basic-troubleshooting.mdx, menu-principal/referencia/build/edge-application/domains/domains.mdx, menu-principal/referencia/build/edge-application/error-responses.mdx, menu-principal/referencia/build/edge-application/origins.mdx, menu-principal/referencia/build/edge-application/v3/edge-application-v3.mdx, menu-principal/referencia/build/edge-application/v3/main-settings-v3.mdx, menu-principal/release-notes/release-notes.mdx, JourneyAPI/pt/snippet.mdx, LetsEncryptExpiration/pt/snippet.mdx

The pt-br style guide localizes aside labels (guia-de-estilo/componentes.mdx, guia-de-estilo/convencoes/paginas-bilingues.mdx): :::note[nota], :::tip[dica], :::caution[Atenção], with Atenção capitalized. 435 pt-br asides already carry these labels, and the docs style gate flags the unlabelled ones as P1. This PR labels 21 of the 57 unlabelled pt-br asides on main and capitalizes the two [atenção] labels as [Atenção]. Every changed line is an aside opener. No aside body, link, or frontmatter field changes.

What the reader sees. An unlabelled pt-br aside did not show English text before this change. DocCallout has no title row, and the .md twin already headed it with a localized Nota, Dica, or Atenção. With the label, the HTML callout opens with nota — , dica — , or Atenção — , like the other pt-br asides, and the .md twin heads the blockquote with the label as written (**nota**). The three **Aumente limites** tips now read dica — **Aumente limites**, which is the :::tip[dica] example the style guide itself gives.

The two snippets. JourneyAPI/pt is included only by build-jornada/edite-edge-app/main-settings.mdx, which #2587 deletes. No page imports LetsEncryptExpiration/pt today, but the style guide lists it as an available snippet. Both stay in the repository for reuse, so the fix holds there.

What this PR leaves alone, on purpose:

• 36 unlabelled asides wait for a second pass:
  • 22 asides on 12 pages that open PRs delete.
    • docs(nav): triage the pages outside the navigation (MM-16244) #2593 deletes framework-overview, lang-wasm, form-builder, and criar-certificado.
    • docs(platform): retire the v3 build and deploy journey pages #2587 deletes zero-touch-provisioning, deploy-service, deploy-jornada/overview, and active-em-producao.
    • docs(secure): retire the pre-Workloads security journey and guide pages #2586 deletes configurar-mtls, proteja-infraestrutura, and edge-firewall-monitorar-metricas.
    • docs(orchestrator): consolidate duplicate guides and write How it works #2588 deletes edge-node-first-steps.
  • 13 asides that an open PR rewrites at or next to the line.
    • docs(orchestrator): split how-tos into API v4 and API v3 pages #2584 touches 9: desinstalar-node.mdx:83, rodar-scripts.mdx:40,56,116,139,308, and trabalhar-com-variaveis.mdx:24,121,239. rodar-scripts.mdx:56 sits right after the block docs(orchestrator): split how-tos into API v4 and API v3 pages #2584 removes, so git merge-tree reports a conflict there.
    • docs(orchestrator): consolidate duplicate guides and write How it works #2588 touches instalar-orch-agent.mdx:41,72.
    • docs(terminology): retire Edge Node, module, and add-on from current pages #2618 touches infra-automation.mdx:17 and managed-configurations.mdx:16.
  • guia-de-estilo/conteudo/referencia.mdx:153. It sits inside an example that is in en-US on purpose.
• Custom pt-br labels. [Opcional], [Importante], [Obsoleto], [Descontinuado], and [Em liberação gradual] say more than the type does, and they mirror their English twins.
• Casing drift that open PRs already resolve. docs(templates): migrate the legacy template guides to the current guide pattern (MM-16246) #2597 removes [Nota] and the two [importante] labels from the template guides. docs(platform): retire the v3 build and deploy journey pages #2587 deletes MainSettingsSAN.mdx, which has the third [atenção].
• The LetsEncryptExpiration type mismatch. The en twin is a note and the pt twin is a caution, a separate question of content parity.
• Code. This PR does not change Aside.astro or the Markdown twin. Content and code stay in separate PRs.

How I checked it:

• The diff. git diff --numstat shows 23 lines added and 23 removed across 12 files, with no line-ending churn. A grep of the diff finds no changed line that is not an aside opener.
• What remains unlabelled. Unlabelled pt-br aside openers drop from 57 to 36, and the 36 that remain are exactly the ones listed above.
• Conflicts with open PRs. I ran git merge-tree from this branch and from main against the head of all 45 open PRs. This branch adds no conflict to any of them. I dropped rodar-scripts.mdx:56 after it conflicted with docs(orchestrator): split how-tos into API v4 and API v3 pages #2584.
• The docs style gate. docs_gate.py --check findings on these files go from 41 on main to 20. The 21 removed findings are all aside-label P1s, and no finding is new. The 4 aside-label findings that remain are the deferred lines in desinstalar-node and instalar-orch-agent, plus the custom [Importante] in the release notes.
• Links. linkcheck.py reports 29 broken rendered links, all already on main and all outside the changed lines.
  • 28 are in edge-application-v3.mdx and 1 is in main-settings-v3.mdx. They point to the old /produtos/build/edge-application/ permalinks.
  • It also flags 2 cross-language links in LetsEncryptExpiration/pt. They are pt-br links inside a pt snippet.
  • This PR changes no link.
• The build. pnpm build:local passes on Node 26: 2092 pages are built, and the frontmatter check exits 0.
• The rendered output. I read the built HTML of origins, domains, and investigacao-problemas-basico, and the origins.md and domains.md twins.
  • The callouts open with Atenção — , nota — , and dica — .
  • The twins head them with > **Atenção**, > **nota**, and > **dica**.
  • I did not open the pages in a browser.

Type of change

• 🆕 New content (feat)
• 🩹 Fix (fix) — typo, broken link, wrong information
• ♻️ Content update (docs) — rewrite, expansion, upkeep
• 🌐 Translation sync (i18n)
• 🏗️ Platform / structure (refactor / chore) — reviewed by UXE, no content mixed in

Author checklist

• PR title follows type(scope): summary (see GOVERNANCE.md §4)
• Frontmatter complete: title, description, meta_tags, namespace, permalink, last_reviewed — none of the 10 pages has last_reviewed, and this PR changes no frontmatter
• No legacy "edge-" product names in the copy — legacy names such as edge node and Edge Application remain on 8 of these pages, and MM-16249 covers them
• How-to/tutorial content includes at least one runnable, copy-paste-tested code block — no how-to or tutorial content is added or changed
• Screenshots (if any) have alt text and follow image standards — no screenshot is added or changed
• Internal links are relative and resolve locally — this PR changes no link, but edge-application-v3.mdx and main-settings-v3.mdx already have 29 broken links to the old /produtos/build/edge-application/ permalinks
• If any permalink changed or page moved: redirect added in this PR — no permalink changed and no page moved
• i18n: pt-br updated in this PR or follow-up i18n issue created: — this PR changes only pt-br content, and the English twins need no change
• I ran pnpm build:local (build + frontmatter check) without errors