Repository navigation
fix(structure): tag bare code fences, fix heading skips, add pt-br meta_tags - #2629
Merged
marcus-souza-azion merged 3 commits intoNov 12, 2026
Merged
Conversation
9 of 14 tasks
marcus-souza-azion
force-pushed
the
fix/mm-16262-structure-headings-meta-fences
branch
from
November 12, 2026 14:45
393e11c to
88c2f5c
Compare
Contributor
|
Rebased this branch onto
The description is updated to match. |
…sing pt-br meta_tags - Tag 23 bare code fences in 17 pages (text for output, mdx for page source). A fence without a language reached CodeBlock with no lang, and the highlighter fell back to JavaScript. - Fix heading skips on 30 pages: the agreements "Previous versions" heading becomes an H2, as on the current Terms of Service; the OpenNext guide moves up one level; a pt-br v3 reference H4 becomes H3, as in en. - Add meta_tags to the 15 pt-br Terms of Service pages that lacked it.
…penNext outline - The style guide keeps meta_tags in US English in both languages, so 18 pt-br Terms of Service carry the English value, 'Terms of Service, Azion Terms of Service', as their English pairs do. November 10, 2020 keeps its Portuguese value until #2625 merges: #2625 rewrites the namespace line right below it. - In the OpenNext guide, the app setup sections become H2 siblings of Prerequisites instead of its children, and the rewritten headings use sentence case, the imperative, and "and" in place of "&".
marcus-souza-azion
force-pushed
the
fix/mm-16262-structure-headings-meta-fences
branch
from
November 12, 2026 14:53
88c2f5c to
f4a67d2
Compare
marcus-souza-azion
deleted the
fix/mm-16262-structure-headings-meta-fences
branch
November 12, 2026 14:57
bruno-andrade-azion
pushed a commit
that referenced
this pull request
Nov 12, 2026
* 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
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
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-16262, in the epic MM-16212
Pages affected: 52 pages in en and pt-br:
meta_tagsmove to English: November 10, 2016, May 15, 2019, August 18, 2020 and October 25, 2017;The ticket's counts come from the October 29 review. I measured them again on
main, parsing frontmatter withgray-matterand skipping code blocks, and most of them don't hold up:mainmeta_tagsnamespacewritten as>-# ...comment inside a code block or a<Code code={...}>template literal. No page has a real H1 in its body.DocUpdaterenders each entry's date as an<h2>. I left them as they are.Code blocks. A fence with no language reaches
CodeBlockwith nolang, becauseastro-code-blocks.tspassesnode.lang ?? undefined. The webkit highlighter then falls back to JavaScript, so output such asHello World!was tokenized as JavaScript.text, the tag docs(fundamentals): apply the reader review and the style guide to the Fundamentals pages #2558 uses.proceduresthat show page source carrymdx, like the block next to them.Heading levels. No legal text changes.
#### Previous versions of this document:becomes## Previous versions of this document. That's how the current Terms of Service already write it. The anchor doesn't change, and the section now shows in the page's table of contents, as it does on the current terms.###. Prerequisites, Local development, Deployment and Best practices become H2, and the two app setup sections, "Create a Next.js app" and "Adapt an existing Next.js app", become H2 siblings of Prerequisites instead of its children. The rewritten headings follow the style guide's headings rules: sentence case, the imperative instead of a gerund, and "and" instead of "&". No link points at the old anchors.meta_tags. The style guide keepsmeta_tagsin US English in both languages (Two languages, Bilingual pages). Fourteen pt-br Terms of Service pages get'Terms of Service, Azion Terms of Service', the value their English pairs carry, and four older pt-br terms that had the Portuguese value switch to it, so 18 pt-br terms now match.namespaceline right belowmeta_tagsin both, so changing them now would conflict. April 26, 2023 doesn't get the line yet, and November 10, 2020 keeps its Portuguese value. Each is a one-line change once i18n(pt-br): pair three pages with their English versions by namespace #2625 merges.How I checked it:
main(12 Nov), the 52 changed files were measured again with a fence and heading-level script: no fence without a language, no skipped level and no H1 in the body. As a control, the same script flags the###start of the OpenNext guide and the bare fence of the Functions quickstart onmain.docs_gate.py --checkfinds nothing new, with 163 findings against 234 onmainfor the same files.linkcheck.pymatchesmainexactly.git merge-treeagainst docs(fundamentals): apply the reader review and the style guide to the Fundamentals pages #2558, docs(applications): Run Function needs only Functions; fix WEBP and CORS prerequisites #2580, docs(platform): retire the v3 build and deploy journey pages #2587, docs(orchestrator): consolidate duplicate guides and write How it works #2588, docs(style-guide): standardize Azion Console click paths #2596, docs(templates): migrate the legacy template guides to the current guide pattern #2597, fix(terminology): replace desempenho and aplicativo in pt-br pages #2621, i18n(pt-br): label unlabelled asides and fix label casing #2622, i18n(pt-br): resync the drifted release notes, punctuation, and Edge Services pairs #2624 and i18n(pt-br): pair three pages with their English versions by namespace #2625 shows the same conflict count asmain, so this branch adds none.git merge-treeagainst every open PR that touches these files: docs(applications): Run Function needs only Functions; fix WEBP and CORS prerequisites #2580, docs(platform): retire the v3 build and deploy journey pages #2587, docs(orchestrator): consolidate duplicate guides and write How it works #2588, docs(style-guide): standardize Azion Console click paths #2596, fix(terminology): replace desempenho and aplicativo in pt-br pages #2621, i18n(pt-br): label unlabelled asides and fix label casing #2622 and i18n(pt-br): pair three pages with their English versions by namespace #2625. Once the April 26meta_tagsline was out, this branch caused no conflict with any of them. docs(applications): Run Function needs only Functions; fix WEBP and CORS prerequisites #2580, docs(platform): retire the v3 build and deploy journey pages #2587 and docs(style-guide): standardize Azion Console click paths #2596 already conflict withmain, but only in files this PR doesn't touch.docs_gate.py --check) on the 49 files finds nothing new and reports 69 fewer findings thanmain. The ones that go away are the heading skips, the colons in headings and the missingmeta_tags.linkcheck.pyreturns the same result as onmain:/tds/29-agosto-2024/, and one in the pt-br v3 Main Settings reference;pnpm ci:ratchet slugcheckpasses at baseline 6.pnpm ci:ratchet linkcheckpasses on the build: 159 broken links against a baseline of 221. This PR changes no link, so it doesn't account for the drop.pnpm lint:navcheckpasses.pnpm build:localpasses with Node 26: 2,092 pages, plus the frontmatter test. In the built HTML:CodeBlockwithlang: "text"and renders as a single text token;h2with a table-of-contents link;h2;http-error-status-codes, fixed by docs(fundamentals): apply the reader review and the style guide to the Fundamentals pages #2558) still renders with nolang, andHost example.comsplits into JavaScript type, function and punctuation tokens..mdxin this repository, so it checks nothing here.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 in the repository carrieslast_reviewed, and the pt-br April 26, 2023 terms getmeta_tagsonly after i18n(pt-br): pair three pages with their English versions by namespace #2625 mergespt-brupdated in this PR or follow-upi18nissue created: both languages are in this PRpnpm build:local(build + frontmatter check) without errors — it passed before the rebase; after the rebase and the review fixes, the CI Build check is what verifies it