Pull Learn, Tutorials, Templates, and Guides into /dev - #21095
Merged
Conversation
Learn — tutorials, official templates, community examples, and a glossary — now ships from pulumi/marketing-web (apps/www) at /learn, with its own S3 + CloudFront (pulumi/marketing-web#82). www.pulumi.com is otherwise Hugo out of this repo, so this is the pulumi/docs half of the cutover. Routing. infrastructure/index.ts gains a /learn* behavior pointed at the Learn stack's cloudFrontDomain, the same shape as /registry and /guides. It uses the thirty-minute policy because that one keys on Accept: the Learn origin rewrites a page URL to its .md twin when the viewer asks for markdown, and the two representations must not collide in the apex cache. learnStack is optional, so dev stacks and PR previews are unchanged. Content. content/tutorials/ (48 pages + 13 glossary terms) and content/templates/ (23 pages) are deleted along with their layouts, partials, shortcodes, archetypes, scaffolding scripts, SCSS, data files, and the `collections` taxonomy. Slugs are 1:1 on the other side, so scripts/redirects/learn-redirects.txt is 99 301s: /tutorials/<path>/ → /learn/tutorials/<path>/, /templates/<path>/ → /learn/official-templates/<path>/, the glossary to /learn/glossary/, the six collection term pages to their browse facet landings, and the frontmatter aliases those pages carried. Every target was checked against a local build of apps/www. Links. Everything outside content/blog/ now points at /learn (blog rides the 301s, per AGENTS.md). The one exception is six architecture.png references in walkthrough-of-adopting-infrastructure-as-code: those are assets, not pages, and no redirect covers them, so the images moved into the post's bundle. Search still covers docs and the Registry only — /learn has its own search at /learn/browse and is not merged into the Algolia index. What goes is the dead scaffolding the deleted pages leave behind: the Tutorials and Templates section mappings in page.js, the /templates ranking rule, the Tutorials facet in the docs search box, and its icon. robots.txt gets a second Sitemap: directive for /learn/sitemap-index.xml — a separate directive rather than an entry in ours, since nesting one sitemap index inside another isn't defined by the spec — plus a pointer to /learn/llms.txt. Nav keeps its Templates slot (now /learn/official-templates/) and the Tutorials entry becomes Learn. Both files are synced downstream by marketing-web, so Learn's own chrome picks the change up. Still to land in pulumi/marketing-web: redirects for the old /learn/... alias URLs (/learn/pulumi-fundamentals/ and friends). Those are Hugo aliases today; once /learn* proxies away, this repo can't answer them. The provenance is already recorded there as `aliases` frontmatter on the ported pages. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The Azure and Kubernetes get-started pages linked /learn/pulumi-fundamentals, which was a Hugo alias of the old /tutorials page rather than a real URL. Now that /learn* proxies away, this repo can't answer it, so both point at the canonical /learn/tutorials/pulumi-fundamentals/. That leaves content/docs/ with no link that depends on an alias being ported downstream. run-pulumi.sh invalidates /registry/* and /guides/* after a deploy but had no /learn/*, which is now cached at the apex for thirty minutes like the other two. /tutorials/* stays, since the pre-cutover HTML still needs flushing. The Vale file filter in the three claude-* workflows still matched content/tutorials/. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Comments that restate the code they sit on, in the files this branch touched: the /learn origin and behavior block in infrastructure/index.ts (the same shape as /registry and /guides directly above it), the section headers in learn-redirects.txt, four in howto-entity.html, and the menu-tree list item. Two carried something real and are gone anyway, worth a look before merge: "/learn* has no trailing slash on purpose" and the cascade `path` note in config.yml (it matches the logical taxonomy path /industry/..., not the permalink /case-studies/industry/...). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
jeffmerrick
marked this pull request as ready for review
August 24, 2026 15:28
github-actions
Bot
added
review:triaging
Contributor
|
📦 Oversized PR — this diff (+295/−19935 across 100 files) exceeds the automated review budget, so the Claude review is skipped ( A diff this size is usually mostly generated output, which an automated line-review can't finish (and wouldn't add value to). What works better:
|
github-actions
Bot
removed
the
review:triaging
![unblocked[bot]](https://avatars.githubusercontent.com/in/166219?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
✅ No issues found
About Unblocked
Unblocked has been set up to automatically review your team's pull requests to identify genuine bugs and issues.
📖 Documentation — Learn more in our docs.
💬 Ask questions — Mention @unblocked to request a review or summary, or ask follow-up questions.
👍 Give feedback — React to comments with 👍 or 👎 to help us improve.
⚙️ Customize — Adjust settings in your preferences.
Collaborator
…ite-migration # Conflicts: # content/tutorials/esc-managed-chatapp/index.md # content/tutorials/esc-setup-psp-creds/index.md # content/tutorials/esc-version-tagging/index.md
…ite-migration # Conflicts: # content/templates/container-service/aws/index.md # content/templates/container-service/azure/index.md # content/templates/container-service/gcp/index.md # content/templates/kubernetes-application/helm-chart/index.md # content/templates/kubernetes-application/web-application/index.md # content/templates/kubernetes/aws/index.md # content/templates/kubernetes/azure/index.md # content/templates/kubernetes/gcp/index.md # content/templates/serverless-application/aws/index.md # content/templates/serverless-application/azure/index.md # content/templates/serverless-application/gcp/index.md # content/templates/static-website/azure/index.md # content/templates/static-website/gcp/index.md # content/templates/virtual-machine/aws/index.md # content/templates/virtual-machine/azure/index.md # content/templates/virtual-machine/gcp/index.md # content/tutorials/building-with-pulumi/secrets/index.md # content/tutorials/creating-resources-aws/index.md # content/tutorials/creating-resources-azure/index.md # content/tutorials/creating-resources-gcp/index.md # content/tutorials/creating-resources-kubernetes/index.md # content/tutorials/inspecting-infrastructure/index.md # content/tutorials/pulumi-fundamentals/create-a-pulumi-project/index.md # content/tutorials/stack-outputs-refs-aws/index.md # content/tutorials/stack-outputs-refs-azure/index.md # content/tutorials/stack-outputs-refs-gcp/index.md # layouts/partials/schema/utils/related-content.html # layouts/partials/tutorials/right-nav-ad.html
This was referenced Aug 25, 2026
…ite-migration # Conflicts: # archetypes/templates/template/index.md # archetypes/templates/type/_index.md # archetypes/tutorials/module/_index.md # archetypes/tutorials/single/index.md # archetypes/tutorials/topic/index.md
Reorients the migration: the pulumi/marketing-web distribution now mounts at /dev (the Dev Center) instead of /learn. Repoints every content link, the CloudFront origin behavior and its `devStack` config, the /tutorials and /templates 301 destinations, robots/llms indexes, and nav/footer labels; renames scripts/redirects/learn-redirects.txt to dev-redirects.txt. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adds a static 301 so the old /learn landing lands on the Dev Center's tutorials index at its new /dev home. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
cnunciato
changed the title
The deleted /tutorials pages carried /learn/... aliases (pulumi-fundamentals, building-with-pulumi, embedding-pulumi, abstraction-encapsulation, and the glossary), so those were live URLs. 301 each to its new /dev home and add /learn/* to the deploy invalidation paths. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…ite-migration # Conflicts: # archetypes/templates/template/index.md # content/tutorials/creating-resources-gcp/index.md # content/tutorials/creating-resources-kubernetes/index.md
cnunciato
changed the title
cnunciato
changed the title
…ite-migration # Conflicts: # layouts/taxonomy/collection.html
Removes the pulumi/guides CloudFront origin/behavior and its testing/production stack config, and drops /guides/sitemap.xml from the sitemap index. The four solutions ported to pulumi/examples 301 to their /dev/examples pages; every other /guides/* URL, including /guides itself, 301s to /dev/tutorials (from the live /guides sitemap). Updates TAXONOMY.md to match. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
cnunciato
changed the title
cnunciato
changed the title
/learn, /tutorials, /templates, and /guides into /dev
cnunciato
changed the title
/learn, /tutorials, /templates, and /guides into /dev/dev
…ite-migration # Conflicts: # infrastructure/Pulumi.www-production.yaml # infrastructure/Pulumi.www-testing.yaml # infrastructure/index.ts # scripts/run-pulumi.sh
…ite-migration # Conflicts: # content/tutorials/managing-config-and-secrets/index.md
cnunciato
approved these changes
Sep 4, 2026
cnunciato
left a comment
cnunciato
left a comment
Contributor
There was a problem hiding this comment.
Deployed to testing, and all looks well.
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
3 participants
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.
Cutover half of moving Learn, tutorials, templates, and guides to the Dev Center at
/dev, which ships from pulumi/marketing-web. Depends on #21348 (adds the/devorigin) and on the Dev Center being live in production — don't merge before both.Deletes the Hugo
/tutorialsand/templatestrees (plus thecollectionstaxonomy, layouts, shortcodes, and scaffolding that only served them), retires thepulumi/guidesCloudFront origin, and 301s every retired URL into/devviascripts/redirects/dev-redirects.txt./tutorials/*,/templates/*, and the old/learn/*aliases redirect to their/dev/*equivalents; bare/learngoes to/dev/tutorials/./guidesretired: the four solutions ported to pulumi/examples redirect to/dev/examples/aws-ts-*; everything else, including/guidesitself, goes to/dev/tutorials/.llms.txt,robots.txt, and the sitemap index updated; "Learn" is renamed "Dev Center"./dev/browse.Related: pulumi/marketing-web#125, pulumi/examples#2995