Skip to content

docs(templates): point the remaining Deploy links to the March 2026 catalog (MM-16370) - #2599

Open
bruno-andrade-azion wants to merge 2 commits into
mainfrom
docs/mm-16370-marketplace-gallery-slugs
Open

bruno-andrade-azion wants to merge 2 commits into
mainfrom
docs/mm-16370-marketplace-gallery-slugs

Conversation

@bruno-andrade-azion

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

Copy link
Copy Markdown
Contributor

Summary

  • Points the remaining Deploy links in the Templates reference and the template guides to the slugs the Console + Create gallery opens. The Marketplace catalog was republished on 2026-03-30 under new slugs. The 2024 entries still resolve but sit in the old build category, and the gallery doesn't show them. This moves 39 templates (156 links, en and pt-br). I checked every new slug against the Console marketplace API (/api/marketplace/solution/<vendor>/<slug> → 200) on 2026-11-06.
  • Fixes two links that were already broken. Nuxt 3 Static Boilerplate and Stencil Boilerplate linked console.azion.com/create/<slug> with no vendor segment, which returned 404.
  • Retires the Book Store React guide. The template is gone from the catalog: the API returns 400 for azion-community/book-store-react, and the gallery has no card for it. This removes the en and pt-br guides, the reference row and the guides-tree entry, and redirects the guide URLs to the Templates reference, the same way docs(templates): reconcile Console Deploy links with the current catalog #2563 retired Nuxt Notes.
Template Before After
Angular Boilerplate angular/angular-boilerplate angular/angular--boilerplate
Astro Blog Starter Kit astro/astro-blog-starter-kit astro/astro--blog-starter-kit
Astro Boilerplate astro/astro-boilerplate astro/astro--boilerplate
Clean Astro + Sanity sanity/clean-astro-sanity-app sanity/clean-astro-app
Cosmic + Simple Astro Blog cosmic/cosmic-simple-astro-blog cosmic/simple-astro-blog
Cosmic + Simple Next.js Blog cosmic/cosmic-simple-nextjs-blog cosmic/simple-nextjs-blog
CosmicJS + Agency Website cosmic/cosmic-agency-website cosmic/agency-website
DevsCard azion-community/devscard azion-community/astro-devscard
Docusaurus JavaScript / TypeScript Boilerplate docusaurus/docusaurus-boilerplate-{javascript,typescript} docusaurus/docusaurus-{javascript,typescript}-boilerplate
Gatsby Blog Starter Kit gatsby/gatsby-blog-starter-kit gatsby/gatsby-blog-starter
Gatsby / Hexo / HTMX / Hugo / Jekyll / React / Vue Boilerplate <fw>/<fw>-boilerplate <fw>/<fw>--boilerplate
Next.js Static Boilerplate nextjs/next-static-boilerplate nextjs/next--static-boilerplate
Nuxt 3 Static Boilerplate nuxt-static-boilerplate (no vendor, 404) nuxt/nuxt3-static-boilerplate
Stencil Boilerplate stencil-boilerplate (no vendor, 404) stencil/stencil--boilerplate
VitePress JavaScript / TypeScript Boilerplate vitepress/vitepress-{javascript,typescript}-boilerplate vitepress/vitepress--{javascript,typescript}-boilerplate
Vue3/Vite Boilerplate vitejs/vitejs-vue3-boilerplate vitejs/vite-vue3-boilerplate
Webpage to PDF Resume azion-community/webpage-to-pdf-resume azion-community/astro-webpage-to-pdf-resume
Application Proxy azion/edge-application-proxy azion/application-proxy-template
Dynamic and Static File Optimization azion/dynamic-and-static-file-optimization azion/dynamic-static-file-optimization
Image Optimization azion/image-optimization azion/image--optimization
Static Cache azion/static-cache azion/static--cache
Static Cache + Videoteca Player videofront/static-cache-videoteca-player videofront/static-cache-videoteca
Upstash Rate Limiting upstash/upstash-ratelimit upstash/upstash--ratelimit
WordPress EdgeAccelerator wordpress/wordpress-edgeaccelerator wordpress/wordpress--edgeaccelerator
Bot Manager Lite and TOR Block / Integration Kit / Starter Kit azion/bot-manager-{and-tor-block-starter-kit,integration-kit,starter-kit} azion/bot--manager-{and-tor-block-starter-kit,integration-kit,starter-kit}
QStash Function Scheduler upstash/qstash-edgefunction-scheduler upstash/qstash--edgefunction-scheduler
Qwik Boilerplate / Qwik Minimal qwik/qwik-{boilerplate,minimal} qwik/qwik--{boilerplate,minimal}
Upstash GeoLocation upstash/upstash-geolocation upstash/upstash--geolocation

How to test

  1. Run pnpm dev and open /en/documentation/platform/marketplace/templates/ and /pt-br/documentacao/plataforma/marketplace/templates/.
  2. While signed in to Azion Console, select Deploy on the rows in the table above. Each one should open that template's configuration form, with a Last Updated date of March 2026 or later (QStash: July 2026).
  3. Open a few of the guides in the diff, in en and pt-br, for example /en/documentation/guides/application-development/frameworks/astro-boilerplate/, and select the Deploy link. Each guide should open the same template as its row in the reference.
  4. Confirm Book Store React no longer appears in the Templates reference or in the Guides sidebar.
  5. Run pnpm --filter docs lint:navcheck. It should pass.

URL changes and redirects

Permalinks removed:

  • /en/documentation/guides/application-development/frameworks/book-store-react/ -> /en/documentation/platform/marketplace/templates/
  • /pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/book-store-react/ -> /pt-br/documentacao/plataforma/marketplace/templates/

Redirects:

  • Added both entries above, in apps/docs/redirects/en/01.json and apps/docs/redirects/pt-br/01.json.
  • Changed the older /en/documentation/products/guides/book-store-react/ and /pt-br/documentacao/produtos/guias/book-store-react/ entries (same files) to point to the Templates reference, so they don't chain to a removed page.

Notes

  • How the slugs were checked (2026-11-06): I listed the catalog with ?group=recommended (257 entries) and ?group=templates (223, both generations), and called the API for each slug in this PR. All 39 targets return 200, updated between 2026-03-13 and 2026-07-03. The gallery shows one card per template name. I clicked 12 cards: Astro Boilerplate, Application Proxy, the three Bot Manager kits, Devscard, Nuxt 3 Static, Qwik Minimal, Stencil, Upstash Rate Limit, QStash and Static Cache + Videoteca. Each one opened the slug in this PR. The click mattered most for Bot Manager, where the 2024 and 2026 entries share the security category.
  • Left as they are: AI Inference Starter Kit, Functions Starter Kit, LangGraph, the three Drizzle kits, Nuxt Content, the Preact boilerplates, SQL Starter Kit and VuePress Boilerplate already use the March 2026 entries (docs(templates): reconcile Console Deploy links with the current catalog #2563). The catalog lists three entries named AI Inference Starter Kit. The gallery card opens azion/ai-inference-starter-kit, the one the reference already uses.
  • Expected conflicts: docs(templates): point Deploy links to the current Marketplace catalog (MM-16236) #2582 (MM-16236) edits the Azion Starter Kit, Gatsby E-commerce Theme and MongoDB Atlas rows and the collection guides. docs(templates): list the Astro templates that only the showcase covered (MM-16247) #2595 (MM-16247) adds 12 Astro rows. Both touch the two reference pages next to rows this PR changes. Keep both sides. docs(templates): list the Astro templates that only the showcase covered (MM-16247) #2595 also edits both redirects/*/01.json files, in different entries (the /products/templates/* targets), so those should merge cleanly. Neither PR touches the guides this PR edits.
  • Follow-up, not in this PR: architecture pages. architectures/bot-management/bot-management-architecture.mdx (en and pt-br) links three slugs that return 400: azion/bot-manager-lite-and-tor-block-starter-kit, azion/bot-manager-lite-integration-kit and azion/bot-manager-lite-starter-kit. The gallery slugs are azion/bot--manager-*. The security modernization and image processing architecture pages still link the 2024 entries azion/dynamic-and-static-file-optimization and azion/image-optimization.
  • Not rechecked: template names and descriptions in the guides against the republished entries. For example, the gallery now calls Edge Application Proxy "Application Proxy".
  • Checks run locally: lint:navcheck passes with 52 soft warnings (row sizes and English fallbacks). The only one this PR touches is the frameworks group of the Guides tree, now one row shorter. lint:links reports 1037 findings, down from 1039 on main because the two removed guides had findings; nothing new. lint:slugcheck reports the same 6 issues as main. The azion-docs-writer linkcheck.py finds 0 issues on the 80 changed pages. lint:linkcheck:nobuild didn't run locally because tsm can't resolve src/consts under Node 26, so CI covers it. I didn't run a full build.
  • Jira: MM-16370 · Epic MM-16212 · Related MM-16218, MM-16236, MM-16247

…atalog

Moves 39 templates (156 links, en and pt-br) in the Marketplace templates
reference and their guides from the 2024 Console catalog entries to the
slugs the + Create gallery opens. Fixes the Nuxt 3 Static and Stencil
links, which had no vendor segment and returned 404.

Verified against the Console marketplace API and gallery on 2026-11-06.
The template is no longer in the Console catalog (the marketplace API
returns 400 and the + Create gallery has no card for it). Removes the en
and pt-br guides, the reference rows and the guides-tree entry, and
redirects the guide URLs, plus the older /products/guides/ URLs that
chained to them, to the Templates reference.

This branch has not been deployed

No deployments
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.

2 participants