Repository navigation
docs(templates): migrate the legacy template guides to the current guide pattern (MM-16246) - #2597
Open
bruno-andrade-azion wants to merge 6 commits into
Open
bruno-andrade-azion wants to merge 6 commits into
bruno-andrade-azion wants to merge 6 commits into
Conversation
…ent guide pattern Refs MM-16246
…he current guide pattern Refs MM-16246
…o the current guide pattern Refs MM-16246
…the current guide pattern Refs MM-16246
…o the current guide pattern Refs MM-16246
…titles Refs MM-16246
This branch has not been deployed
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.
Summary
## Prerequisites, imperative task sections withDocSteps, and## Next stepswith twoDocCards. The old Requirements / Deploying / Setting up / Managing boilerplate is gone, and so are "Fill in the presented fields", "You'll be redirected…" and the "Products menu" click path.https://www.azion.com/en/documentation/...links are now relative. "Set Origin" becomes Set Connector, as the Rules Engine reference names it. "EdgeSQL" becomes SQL Database, the legacy API operation link is replaced, and "edge stack" / "edge latency" / "on the Edge" are gone. In pt-br, "desempenho" is replaced with "performance" and leftover untranslated lines are translated.<Video>embeds, code blocks, and template-specific sections (static-export support, database setup, QStash schedules, rate-limiting behavior) are all kept. The cross-link text on 8 other pages was updated to the new titles.Scope: the ticket counted ~43 legacy guides. The current count is 49 guides without Next steps; this PR migrates 39 of them. The other 10 are also changed by #2582 (MM-16236, Deploy slugs), so they will be migrated in a follow-up PR after #2582 merges, to avoid a conflict: astro-, eleventy-, hugo-, jekyll- and nextjs-ecommerce-collection, gatsby-ecomerce-theme, vuepress-templates-collection, butter-cms, mongodb-template and azion-starter-kit. This PR does not depend on #2582.
Commits are grouped by template family (framework boilerplates, blogs/CMS, databases and LangGraph, functions and Upstash, cache and optimization, cross-link text), so the review can go one commit at a time.
How to test
cd apps/docs && pnpm build:local. Expected: the build completes (2092 pages) andtest:frontmatterpasses./en/documentation/guides/application-development/frameworks/angular-boilerplate/and its pt-br twin/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/angular-boilerplate/. Expected: the new section order, the Deploy link inside the first step, two Next steps cards, and the internal Pricing link.pnpm ci:ratchet linkcheck(161 vs baseline 221),pnpm ci:ratchet webkit-adoption(4 vs 56),pnpm ci:ratchet astro-check(31 vs 32),pnpm ci:ratchet slugcheck(6 vs 6) andpnpm lint:navcheck. All pass.ci/baselines.jsonis not updated, because the lower counts cannot be attributed to this PR.URL changes and redirects
None. Permalinks,
namespaces and file names are unchanged, and so are the typo'd pt-br names such asneon-databse-with-drizzleand the legacyedge-*slugs. Every Console Deploy URL is unchanged byte for byte.Notes
Deliberate choices a reviewer may flag:
Products menu > Functions, copied from the migrated edge-ai-starter-kit guide. The Console path convention belongs to MM-16248 (T36).SME follow-ups, also listed in MM-16246:
vuepress--boilerplatehas a double hyphen, matching the Templates reference. Does it resolve?Related issue: MM-16246 (epic MM-16212).