Skip to content

fix(cache): cache headings update - #2384

Merged
marcus-souza-azion merged 2 commits into
release/new-azion-docsfrom
fix/cache-headings-update
Sep 21, 2026
Merged

marcus-souza-azion merged 2 commits into
release/new-azion-docsfrom
fix/cache-headings-update

Conversation

@marcus-souza-azion

Copy link
Copy Markdown
Contributor

What & why

Six product overviews are built on one template: name the object, walk the path, then bound the
scope. That third slot is called Scope and limits on AI Inference, WAF, Functions, and
Application Accelerator. Cache called it What Cache covers — same slot, same kind, a different
name to retrieve it by. Cache and Image Processor also wrote their scope bullets as
**Interfaces.** The module… where the other four write **Interfaces**: the module…, and Cache
was missing the Billing bullet the others carry. Cheap to fix, and it makes the set answer the
same question the same way for a reader or an agent walking across products.

What changed, in both languages:

  • Cache — What Cache covers → Scope and limits (O que o Cache cobre → Escopo e limites),
    and a Billing bullet added last, where the other four put theirs. Cache is billed on Purges,
    the one metric its pricing section carries; the bullet also names where data transfer is listed,
    so "billed on Purges" can't read as "delivery is free".
  • Cache + Image Processor — the 30 scope bullets converted to the colon form, lowercasing the
    lead word only where it is an ordinary one. Product names, acronyms, and code keep their capital,
    which is what the other four pages already do.
  • Cache — the observability bullet was named Watching it / Acompanhar. It is now
    Observability / Observabilidade, matching AI Inference, WAF, and Functions.
  • Portuguese Cache — the Azion Lib link pointed at an English page; it now points at the
    Portuguese one.

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 — the five other fields are present on all four pages; last_reviewed is absent corpus-wide, so no page satisfies this row as written
  • No legacy "edge-" product names in the copy
  • How-to/tutorial content includes at least one runnable, copy-paste-tested code block
  • Screenshots (if any) have alt text and follow image standards — n/a, no images in the diff
  • Internal links are relative and resolve locally —
  • If any permalink changed or page moved: redirect added in this PR — n/a, no permalink changed and no page moved
  • i18n: pt-br updated in this PR or follow-up i18n issue created:
  • I ran pnpm build:local (build + frontmatter check) without errors

… overviews

The Cache overview was the only one of the six product overviews built on this
template that named its third slot something else: "What Cache covers" where AI
Inference, WAF, Functions, Application Accelerator, and Image Processor all say
"Scope and limits". Same slot, same kind, a different name to retrieve it by.

Rename the heading in both languages, and add the Billing bullet the section was
missing. Cache is billed on Purges, the one metric its pricing section carries;
data transfer is listed there under Application Accelerator, so the bullet says
so rather than letting "billed on Purges" read as "delivery is free".

The object and path headings are left alone: those two slots were never uniform
across the six pages, and Cache's already match Application Accelerator's.
… Image Processor overviews

Four of the six product overviews built on this template write their scope
bullets as "**Interfaces**: the module...". Cache and Image Processor wrote them
as "**Interfaces.** The module...", so the same slot read two ways across the
set. Convert both pages in both languages to the colon form, lowercasing the
lead word where it is an ordinary one and leaving product names, acronyms, and
code as they are, which is the convention the other four already follow.

Cache's observability bullet was also named "Watching it" where AI Inference,
WAF, and Functions all say "Observability". Rename it, and its Portuguese
"Acompanhar" to "Observabilidade".

The Portuguese Cache overview linked Azion Lib at an /en/ URL. Point it at the
Portuguese page. That page's permalink reads /documentacao/produtos/azion-lib/
application/ rather than the /devtools/ its thirteen siblings and all fourteen
English pages use, but the produtos URL is a live redirect destination in
cicd/massive-redirect/pt-br.json, so the link follows the URL that resolves
today and the permalink is left for a URL-ledger decision.
@marcus-souza-azion
marcus-souza-azion requested a review from a team as a code owner September 21, 2026 23:30
@marcus-souza-azion
marcus-souza-azion merged commit d95105d into release/new-azion-docs Sep 21, 2026
6 of 8 checks passed
@marcus-souza-azion
marcus-souza-azion deleted the fix/cache-headings-update branch September 21, 2026 23:35
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