Skip to content

i18n(pt-br): label unlabelled asides and fix label casing - #2622

Merged
marcus-souza-azion merged 2 commits into
mainfrom
i18n/pt-br-aside-labels
Nov 12, 2026
Merged

marcus-souza-azion merged 2 commits into
mainfrom
i18n/pt-br-aside-labels

Conversation

@bruno-andrade-azion

@bruno-andrade-azion bruno-andrade-azion commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

What & why

Related issue: MM-16255
Pages affected: 12 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, arquiteturas/orch/infra-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/referencia/servicos/managed-configurations.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 23 of the 50 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 release notes. The one change there is the label of the closing aside of an older Azion CLI entry. It localizes the label and changes nothing the entry records, as #2624 did for the drifted entries. lint:changelog reports no issue on the page.

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:

How I checked it:

  • The diff. git diff --numstat shows 25 lines added and 25 removed across 14 files. A grep of the diff finds no changed line that is not an aside opener.
  • What remains unlabelled. Unlabelled pt-br aside openers, counted with trailing whitespace allowed, drop from 50 on main to 27, and the 27 that remain are exactly the ones listed above.
  • Conflicts with open PRs. The branch is rebased on current main. I ran git merge-tree from this branch and from main against the head of all 35 other open PRs. This branch adds no conflict to any of them. infra-automation.mdx:17 and managed-configurations.mdx:16 waited on docs(terminology): retire Edge Node, module, and add-on from current pages #2618, which merged; fix(terminology): replace desempenho and aplicativo in pt-br pages #2621 is the only open PR that touches either file, and it merges cleanly.
  • The docs style gate. docs_gate.py --check reports no aside-label finding on the changed lines. The ones that remain on these files are the deferred lines in desinstalar-node and instalar-orch-agent, plus the custom [Importante] in the release notes.
  • Links. This PR changes no link. edge-application-v3.mdx and main-settings-v3.mdx already carry 29 broken links to the old /produtos/build/edge-application/ permalinks on main.
  • The rendered output. On the previous head, 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 — , and 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 12 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 several 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 — it passed on Node 26 on the previous head (2092 pages, frontmatter check exit 0); on this head, the CI Build check runs it

egermano and others added 2 commits November 12, 2026 12:48
Label 21 unlabelled Brazilian Portuguese asides with the localized labels
the style guide sets (nota, dica, Atenção), so they match the ~440 pt-br
asides already labelled. Capitalize the two `[atenção]` labels to
`[Atenção]`, the casing the style guide fixes.

Asides in files that open pull requests delete or rewrite at or next to
those lines are left for after those merge.
@marcus-souza-azion
marcus-souza-azion merged commit f20caf7 into main Nov 12, 2026
10 checks passed
@marcus-souza-azion
marcus-souza-azion deleted the i18n/pt-br-aside-labels branch November 12, 2026 16:02
bruno-andrade-azion pushed a commit that referenced this pull request Nov 12, 2026
* 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
bruno-andrade-azion pushed a commit that referenced this pull request Nov 12, 2026
* 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 pushed a commit that referenced this pull request Nov 12, 2026
* origin/main: (48 commits)
  docs(templates): list the Astro templates that only the showcase covered (#2595)
  docs(orchestrator): consolidate duplicate guides and write How it works (#2588)
  docs(secure): retire the pre-Workloads security journey and guide pages (#2586)
  docs(applications): Run Function needs only Functions; fix WEBP and CORS prerequisites (#2580)
  docs(fundamentals): apply the reader review and the style guide to the Fundamentals pages (#2558)
  fix(observe): name the query editor list instead of its position in the Grafana guides (#2643)
  docs(templates): migrate the legacy template guides to the current guide pattern (#2597)
  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)
  ...

# Conflicts:
#	apps/docs/src/content/docs/en/pages/main-menu/reference/accounts/billing.mdx
#	apps/docs/src/content/docs/en/pages/main-menu/reference/accounts/teams-permissions.mdx
#	apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/contas/faturamento.mdx
#	apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/contas/teams-permissions.mdx
bruno-andrade-azion pushed a commit that referenced this pull request Nov 12, 2026
Resolve the 16 conflicts in the current Orchestrator how-tos: keep the
PR's Console-only layout with main's Console steps (#2596) and the
authorize additions from #2588.

Rebuild the 16 -v3 pages from main's version of each page, so they carry
the Console click paths (#2596), the #2574 review fixes, the pt-br link
and aside fixes (#2620, #2622), and the authorize additions (#2588).

Also apply the PR review:
- en create-service: move the active-service note out of the step list
  and drop its contractions
- en descriptions: start with the verb instead of "Learn how to"
- pt-br run-scripts: replace the "borda" DocButton labels

Refs MM-16233
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3 participants