Skip to content

fix(links): point the v3 Applications reference and the guides at the current pages - #2646

Merged
marcus-souza-azion merged 2 commits into
mainfrom
fix/mm-16193-internal-links
Nov 12, 2026
Merged

marcus-souza-azion merged 2 commits into
mainfrom
fix/mm-16193-internal-links

Conversation

@marcus-souza-azion

@marcus-souza-azion marcus-souza-azion commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

What & why

Related issue: MM-16193
Pages affected:

  • /en/documentation/platform/applications/v3/ · /pt-br/documentacao/plataforma/applications/v3/
  • /en/documentation/platform/applications/main-settings-v3/ · /pt-br/documentacao/plataforma/applications/main-settings-v3/
  • the serverless-functions, run-a-function-on-one-path-and-roll-it-back and modernize-a-monolithic-application-without-a-rewrite pages, en and pt-br
  • /en/documentation/agreements/faqs/
  • release notes, en and pt-br (closing line only)

This PR fixes 52 of the 137 issues the linkcheck ratchet counts on main today. It changes link targets, plus the closing sentence of the release notes in en and pt-br. It is content only: it does not touch ci/baselines.json or the checker. A follow-up UXE PR lowers the baseline to whatever its own CI measures, after it adds the exemption for the Marketplace Agreement, which exists only in English.

The v3 reference points at the pages its readers already land on (43 broken links). The two v3 Applications pages, in en and pt-br, still linked the /products/build/edge-application/... URLs. Every one of those URLs has a row in apps/docs/redirects/{en,pt-br}/*.json that ends on a published page, and each link now points at that page, so a reader who clicks it reaches the same page as before, without the redirect. Three links are the exception, because the redirect lands somewhere the link does not promise:

  • The English "Build your first Applications" button points at the Applications quickstart, like the pt-br button and the "First steps" row on the same page. The two redirect rows for products/get-started/ disagree (00.json sends it to azion-platform-overview, 01.json to fundamentals/how-it-works), and neither is a quickstart.
  • The Main Settings row of the settings table (Delivery Settings in pt-br) points at main-settings-v3, as the page's other Main Settings link already does, instead of the v4 page.
  • The "file slicing" link pointed at cache-settings/#slice-settings in en and edge-cache/#slice-settings in pt-br. File slicing is now documented as Large File Optimization, so both languages point at #large-file-optimization on Expiration and freshness.

Six pages link the right section of Main Settings again (6 broken anchors). The #products / #produtos anchor no longer exists. The switches these links point at, which turn Functions on for an Application, now sit under ## Platform Resources / ## Recursos da plataforma, so the links use #platform-resources / #recursos-da-plataforma.

Smaller fixes (3).

  • The two Data Privacy FAQ links in /en/documentation/agreements/faqs/ get their trailing slash.
  • The release notes closing line "Learn more about previous years [here]" now names the page it links to. The pt-br line changes the same way, to keep the pair aligned.

Out of scope, by decision. The previous-years changelog, the dated Terms of Service pages, and the "here" links inside old release-notes entries are historical documents and stay as they are. They make up the 43 issues that will remain.

How I checked it:

  • astro build with the localhost consts plus pnpm test:frontmatter (the two steps of build:local), then pnpm lint:linkcheck:nobuild on the build. The result was Found 85 link issues, down from 137 on main f6f95a43f, and comparing the two outputs shows no new issue.
  • I resolved every new target against the published permalinks, and checked every anchor against the ids in the built HTML, #large-file-optimization included.
  • After the second commit, the build-free link check on the two v3 pages reports no broken link, and pnpm lint:links stays at 1110.
  • git diff --word-diff on the v3 pages changes only URL tokens.
  • pnpm lint:links: 1112 findings on main, 1110 on the branch, none new.
  • pnpm lint:changelog: no issues.
  • prettier --check on the changed files passes.
  • The style gate on the touched pages: findings drop from 37 to 34, the 3 link findings this PR fixes, and none new.
  • Two open PRs touch the same files on other lines: fix(agreements): fix the FAQ index links and move the 2016 SLA off the current page #2633 changes the frontmatter of faqs-index.mdx, and docs(platform): retire the v3 build and deploy journey pages #2587 changes line 116 of both serverless-functions.mdx files. Neither conflicts.
  • Not checked: I did not click through 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 — no frontmatter is changed
  • No legacy "edge-" product names in the copy — no copy is changed; the v3 pages keep the v3 names they document
  • How-to/tutorial content includes at least one runnable, copy-paste-tested code block — no code block 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
  • 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: pt-br is updated in this PR
  • I ran pnpm build:local (build + frontmatter check) without errors — not run as one command; I ran its two steps directly (astro build with the localhost consts, then pnpm test:frontmatter), and both passed

… current pages

Retarget the v3 Applications reference links to the pages their redirects
already land on, move six Main Settings links to the Platform Resources
anchor, add the trailing slash to the two Data Privacy FAQ links, and name
the target in the release notes closing line. Content only: the linkcheck
count drops from 137 to 85; the baseline moves in a separate tooling PR.
The English "Build your first Applications" button goes to the Applications
quickstart, as the pt-br button does; the v3 settings table links
main-settings-v3 instead of the v4 page; and "file slicing" lands on the
Large File Optimization section of Expiration and freshness.
@marcus-souza-azion

Copy link
Copy Markdown
Contributor Author

Review: clean. This PR went through two review rounds, a correctness review and a check against the documentation style guide. It is ready for SME and DevRel sign-off.

  • Round 1 found three link targets that did not match their link text. Commit 4339bda fixes them, and the description lists them:
    • The English "Build your first Applications" button now goes to the Applications quickstart.
    • The v3 settings table now links to main-settings-v3.
    • "File slicing" now links to #large-file-optimization.
  • Round 2 (on 4339bda) found nothing to fix:
    • All 52 new targets resolve to published pages in their own language.
    • The #platform-resources, #recursos-da-plataforma and #large-file-optimization anchors exist in the built HTML.
    • 67 of the old-to-new link pairs end exactly where the redirect chain ends. The other 7 are the documented exceptions.
    • No page outside the historical documents still links the legacy /products/ paths or the #products / #produtos anchors.
    • Every CI check passes, Internal links included.
  • Left out of this PR on purpose:
    • The duplicate products/get-started/ redirect rows (redirects/en/00.json:7 and 01.json:1879).
    • The v3 page linking to v4 pages where no v3 page exists.

@marcus-souza-azion
marcus-souza-azion merged commit 81f80bf into main Nov 12, 2026
10 checks passed
@marcus-souza-azion
marcus-souza-azion deleted the fix/mm-16193-internal-links branch November 12, 2026 21:43
bruno-andrade-azion pushed a commit that referenced this pull request Nov 13, 2026
…paths-followup

* origin/main:
  docs(workloads): review the Workloads section with the style guide and correct it from live tests (#2570)
  fix(ai-inference): review the AI Inference section and correct it from live tests (#2641)
  docs(templates): apply the review of the migrated template guides (#2645)
  docs(templates): point Deploy links to the current Marketplace catalog (MM-16236) (#2582)
  docs(orchestrator): split how-tos into API v4 and API v3 pages (#2584)
  fix(accounts): hyphenate Real-Time Purge and name the Bills tab in the permissions table (#2581)
  chore(lint): accept the English-only Marketplace Agreement and lower the linkcheck baseline (#2647)
  fix(links): point the v3 Applications reference and the guides at the current pages (#2646)
  docs(runtime): migrate Node.js API samples to the ES Modules handler (MM-16245) (#2592)

# Conflicts:
#	apps/docs/src/content/docs/en/pages/deploy-journey/advanced-config/run-scripts/run-scripts.mdx
#	apps/docs/src/content/docs/en/pages/guides/getting-to-know-azion-console/getting-to-know-azion-console.mdx
#	apps/docs/src/content/docs/pt-br/pages/deploy-jornada/avancado/rodar-scripts/rodar-scripts.mdx
#	apps/docs/src/content/docs/pt-br/pages/guias/conhecendo-o-azion-console/conhecendo-o-azion-console.mdx
bruno-andrade-azion pushed a commit that referenced this pull request Nov 13, 2026
* origin/main: (58 commits)
  docs(workloads): review the Workloads section with the style guide and correct it from live tests (#2570)
  fix(ai-inference): review the AI Inference section and correct it from live tests (#2641)
  docs(templates): apply the review of the migrated template guides (#2645)
  docs(templates): point Deploy links to the current Marketplace catalog (MM-16236) (#2582)
  docs(orchestrator): split how-tos into API v4 and API v3 pages (#2584)
  fix(accounts): hyphenate Real-Time Purge and name the Bills tab in the permissions table (#2581)
  chore(lint): accept the English-only Marketplace Agreement and lower the linkcheck baseline (#2647)
  fix(links): point the v3 Applications reference and the guides at the current pages (#2646)
  docs(runtime): migrate Node.js API samples to the ES Modules handler (MM-16245) (#2592)
  docs(observe): use the current GraphQL dataset names across Observe and guides (#2579)
  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)
  ...
bruno-andrade-azion pushed a commit that referenced this pull request Nov 13, 2026
…nce-soc-pci

* origin/main: (59 commits)
  docs(console): apply the review of the Console path convention (#2644)
  docs(workloads): review the Workloads section with the style guide and correct it from live tests (#2570)
  fix(ai-inference): review the AI Inference section and correct it from live tests (#2641)
  docs(templates): apply the review of the migrated template guides (#2645)
  docs(templates): point Deploy links to the current Marketplace catalog (MM-16236) (#2582)
  docs(orchestrator): split how-tos into API v4 and API v3 pages (#2584)
  fix(accounts): hyphenate Real-Time Purge and name the Bills tab in the permissions table (#2581)
  chore(lint): accept the English-only Marketplace Agreement and lower the linkcheck baseline (#2647)
  fix(links): point the v3 Applications reference and the guides at the current pages (#2646)
  docs(runtime): migrate Node.js API samples to the ES Modules handler (MM-16245) (#2592)
  docs(observe): use the current GraphQL dataset names across Observe and guides (#2579)
  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)
  ...

# Conflicts:
#	apps/docs/src/content/docs/en/pages/main-menu/compliance/pci-dss.mdx
#	apps/docs/src/content/docs/en/pages/main-menu/compliance/soc-2.mdx
#	apps/docs/src/content/docs/pt-br/pages/menu-principal/compliance/pci-dss.mdx
#	apps/docs/src/content/docs/pt-br/pages/menu-principal/compliance/soc.mdx
bruno-andrade-azion pushed a commit that referenced this pull request Nov 13, 2026
* origin/main: (59 commits)
  docs(console): apply the review of the Console path convention (#2644)
  docs(workloads): review the Workloads section with the style guide and correct it from live tests (#2570)
  fix(ai-inference): review the AI Inference section and correct it from live tests (#2641)
  docs(templates): apply the review of the migrated template guides (#2645)
  docs(templates): point Deploy links to the current Marketplace catalog (MM-16236) (#2582)
  docs(orchestrator): split how-tos into API v4 and API v3 pages (#2584)
  fix(accounts): hyphenate Real-Time Purge and name the Bills tab in the permissions table (#2581)
  chore(lint): accept the English-only Marketplace Agreement and lower the linkcheck baseline (#2647)
  fix(links): point the v3 Applications reference and the guides at the current pages (#2646)
  docs(runtime): migrate Node.js API samples to the ES Modules handler (MM-16245) (#2592)
  docs(observe): use the current GraphQL dataset names across Observe and guides (#2579)
  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)
  ...

# Conflicts:
#	apps/docs/redirects/en/01.json
#	apps/docs/redirects/pt-br/01.json
#	apps/docs/src/content/docs/en/homes/architctures/by-use-case/application-and-network-security.mdx
#	apps/docs/src/content/docs/pt-br/homes/arquiteturas/por-solucao/seguranca-de-aplicacoes-e-redes.mdx
bruno-andrade-azion pushed a commit that referenced this pull request Nov 13, 2026
…ts-formatting

* origin/main: (55 commits)
  docs(architectures): keep security-modernization and bot-management as API v3 versions (#2589)
  fix(runtime): clean up unused imports and JSDoc in the Node.js API samples (#2649)
  docs(platform): retire the v3 build and deploy journey pages (#2587)
  fix(compliance): correct the SOC report cadence and PCI DSS version (#2585)
  docs(runtime): fix the azion dev port and the function size limit (#2583)
  docs(console): apply the review of the Console path convention (#2644)
  docs(workloads): review the Workloads section with the style guide and correct it from live tests (#2570)
  fix(ai-inference): review the AI Inference section and correct it from live tests (#2641)
  docs(templates): apply the review of the migrated template guides (#2645)
  docs(templates): point Deploy links to the current Marketplace catalog (MM-16236) (#2582)
  docs(orchestrator): split how-tos into API v4 and API v3 pages (#2584)
  fix(accounts): hyphenate Real-Time Purge and name the Bills tab in the permissions table (#2581)
  chore(lint): accept the English-only Marketplace Agreement and lower the linkcheck baseline (#2647)
  fix(links): point the v3 Applications reference and the guides at the current pages (#2646)
  docs(runtime): migrate Node.js API samples to the ES Modules handler (MM-16245) (#2592)
  docs(observe): use the current GraphQL dataset names across Observe and guides (#2579)
  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)
  ...

# Conflicts:
#	apps/docs/src/content/docs/en/pages/agreements/faqs/faqs-index.mdx
bruno-andrade-azion pushed a commit that referenced this pull request Nov 13, 2026
…uide-coherence

* origin/main: (56 commits)
  docs(architectures): keep security-modernization and bot-management as API v3 versions (#2589)
  fix(runtime): clean up unused imports and JSDoc in the Node.js API samples (#2649)
  docs(platform): retire the v3 build and deploy journey pages (#2587)
  fix(compliance): correct the SOC report cadence and PCI DSS version (#2585)
  docs(runtime): fix the azion dev port and the function size limit (#2583)
  docs(console): apply the review of the Console path convention (#2644)
  docs(workloads): review the Workloads section with the style guide and correct it from live tests (#2570)
  fix(ai-inference): review the AI Inference section and correct it from live tests (#2641)
  docs(templates): apply the review of the migrated template guides (#2645)
  docs(templates): point Deploy links to the current Marketplace catalog (MM-16236) (#2582)
  docs(orchestrator): split how-tos into API v4 and API v3 pages (#2584)
  fix(accounts): hyphenate Real-Time Purge and name the Bills tab in the permissions table (#2581)
  chore(lint): accept the English-only Marketplace Agreement and lower the linkcheck baseline (#2647)
  fix(links): point the v3 Applications reference and the guides at the current pages (#2646)
  docs(runtime): migrate Node.js API samples to the ES Modules handler (MM-16245) (#2592)
  docs(observe): use the current GraphQL dataset names across Observe and guides (#2579)
  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)
  ...

# Conflicts:
#	apps/docs/src/content/docs/en/pages/style-guide/content/information-architecture.mdx
#	apps/docs/src/content/docs/en/pages/style-guide/content/navigation-hubs.mdx
#	apps/docs/src/content/docs/pt-br/pages/guia-de-estilo/conteudo/arquitetura-de-informacao.mdx
#	apps/docs/src/content/docs/pt-br/pages/guia-de-estilo/conteudo/hubs-de-navegacao.mdx
bruno-andrade-azion pushed a commit that referenced this pull request Nov 13, 2026
…inks-use-case-closing

* origin/main: (55 commits)
  docs(architectures): keep security-modernization and bot-management as API v3 versions (#2589)
  fix(runtime): clean up unused imports and JSDoc in the Node.js API samples (#2649)
  docs(platform): retire the v3 build and deploy journey pages (#2587)
  fix(compliance): correct the SOC report cadence and PCI DSS version (#2585)
  docs(runtime): fix the azion dev port and the function size limit (#2583)
  docs(console): apply the review of the Console path convention (#2644)
  docs(workloads): review the Workloads section with the style guide and correct it from live tests (#2570)
  fix(ai-inference): review the AI Inference section and correct it from live tests (#2641)
  docs(templates): apply the review of the migrated template guides (#2645)
  docs(templates): point Deploy links to the current Marketplace catalog (MM-16236) (#2582)
  docs(orchestrator): split how-tos into API v4 and API v3 pages (#2584)
  fix(accounts): hyphenate Real-Time Purge and name the Bills tab in the permissions table (#2581)
  chore(lint): accept the English-only Marketplace Agreement and lower the linkcheck baseline (#2647)
  fix(links): point the v3 Applications reference and the guides at the current pages (#2646)
  docs(runtime): migrate Node.js API samples to the ES Modules handler (MM-16245) (#2592)
  docs(observe): use the current GraphQL dataset names across Observe and guides (#2579)
  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)
  ...
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.

1 participant