Capability-driven information architecture

CLAUDE.md

@@ -29,3 +29,6 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - **Naming**: Use lowercase for non-proper nouns (e.g., "stack" not "Stack" in text)
 - **Ordered Lists**: All items should begin with `1.` regardless of their position in the list.
 
+## Site Architecture Notes
+- **Tutorial Collections**: The file `/data/tutorials/collections.yaml` defines tutorial collections that generate `/tutorials/{id}/` URLs (e.g., `/tutorials/aws/`). However, Hugo internally maps these to `/collections/{id}` paths, so navigation logic must check for both `/tutorials/` and `/collections/` path prefixes.
+

assets/css/bundle.css

@@ -4788,36 +4788,30 @@ section.docs-home div.header{
   background-position: right bottom;
   background-repeat: no-repeat;
   padding: 1.5rem;
-  background-image:url("/images/docs/docs-home-header-background-mobile.svg");
 }
 
 section.docs-home div.header p{
-  max-width: 28rem
+  max-width: 50rem
 }
 
 @media (min-width: 768px){
   section.docs-home div.header{
-    background-size: auto;
-    background-image:url("/images/docs/docs-home-header-background-tablet.svg")
+    background-size: auto
   }
 }
 
 @media (min-width: 1024px){
-  section.docs-home div.header{
-    background-image:url("/images/docs/docs-home-header-background-desktop.svg")
-  }
 }
 
 @media (min-width: 1280px){
   .docs-content-width-expanded section.docs-home div.header{
-    background-image:url("/images/docs/docs-home-header-background-desktop-wide.svg");
     background-position: right
   }
 }
 
 @media (min-width: 1536px){
   .docs-content-width-expanded section.docs-home div.header p{
-    max-width: 32rem
+    max-width: 50rem
   }
 }
 
@@ -4911,6 +4905,18 @@ section.docs-home a.full-width-card div.icon-heading div.icon{
   top:-1px
 }
 
+section.docs-home a.full-width-card div.icon-heading div.icon.emoji-icon{
+  font-size:21px;
+  line-height:21px;
+  width:21px;
+  height:21px;
+  display:flex;
+  align-items:center;
+  justify-content:center;
+  background:transparent;
+  text-indent:0 !important
+}
+
 section.docs-home a.full-width-card:hover{
   background:#f9f9f9;
   border:1px solid #bebfc9
@@ -30266,6 +30272,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{
   max-width: 1536px;
 }
 
+.max-w-50rem{
+  max-width: 50rem;
+}
+
 .flex-1{
   flex: 1 1 0%;
 }
@@ -61013,6 +61023,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{
     max-width: 1536px;
   }
 
+  .sm\:max-w-50rem{
+    max-width: 50rem;
+  }
+
   .sm\:flex-1{
     flex: 1 1 0%;
   }
@@ -91717,6 +91731,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{
     max-width: 1536px;
   }
 
+  .md\:max-w-50rem{
+    max-width: 50rem;
+  }
+
   .md\:flex-1{
     flex: 1 1 0%;
   }
@@ -122421,6 +122439,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{
     max-width: 1536px;
   }
 
+  .lg\:max-w-50rem{
+    max-width: 50rem;
+  }
+
   .lg\:flex-1{
     flex: 1 1 0%;
   }
@@ -153125,6 +153147,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{
     max-width: 1536px;
   }
 
+  .xl\:max-w-50rem{
+    max-width: 50rem;
+  }
+
   .xl\:flex-1{
     flex: 1 1 0%;
   }
@@ -183829,6 +183855,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{
     max-width: 1536px;
   }
 
+  .xxl\:max-w-50rem{
+    max-width: 50rem;
+  }
+
   .xxl\:flex-1{
     flex: 1 1 0%;
   }

content/docs/_index.md

@@ -11,51 +11,28 @@ docs_home: true
 noleftnav: true
 norightnav: true
 nobreadcrumb: true
-h1: Pulumi Docs
+h1: Pulumi <strong>Docs</strong>
 description: <p>Pulumi is an <a href="https://github.com/pulumi/pulumi" target="_blank">open source</a> platform for <a href="/docs/iac">automating</a>, <a href="/docs/esc">securing</a>, and <a href="/docs/pulumi-cloud">managing</a> cloud resources, configuration, and secrets, using your favorite <a href="/docs/iac/languages-sdks/">programming languages.</a></p>
 link_buttons:
   primary:
     label: Get Started
     link: /docs/get-started/
 sections:
 - type: button-cards
-  heading: Featured Products
+  heading: Start with Your Workflow
   cards:
-  - heading: Pulumi IaC
-    description: "Infrastructure as code for engineers in Node.js, Python, Go, .NET, Java, and YAML"
-    link: /docs/iac/
-    primary_button_label: Get Started
-    primary_button_link: /docs/iac/get-started/
-    secondary_button_label: Install
-    secondary_button_link: /docs/iac/download-install/
-  - heading: Pulumi ESC
-    description: "Environments, Secrets and Configuration Management"
-    link: /docs/esc/
-    primary_button_label: Get Started
-    primary_button_link: /docs/esc/get-started/
-    secondary_button_label: Install
-    secondary_button_link: /docs/esc/download-install/
-  - heading: Pulumi IDP
-    description: "Secure, compliant, and customizable developer workflows at scale"
-    link: /docs/idp/
-    primary_button_label: Get Started
-    primary_button_link: /docs/idp/get-started/
-    secondary_button_label: Create an account
-    secondary_button_link: https://app.pulumi.com/signup
-  - heading: Pulumi Insights
-    description: "Asset management, compliance remediation and AI insights over the cloud"
-    link: /docs/insights/
-    primary_button_label: Get Started
-    primary_button_link: /docs/insights/get-started/
-    secondary_button_label: Create an account
-    secondary_button_link: https://app.pulumi.com/signup
-  - heading: Pulumi Cloud
-    description: "Managed service for using Pulumi open source at scale. Use SaaS or self-host"
-    link: /docs/pulumi-cloud/
-    primary_button_label: Get Started
-    primary_button_link: /docs/pulumi-cloud/get-started/
-    secondary_button_label: Create an account
-    secondary_button_link: https://app.pulumi.com/signup
+  - heading: Build
+    description: "Create and deploy cloud infrastructure using your favorite programming languages"
+    link: /docs/build/
+  - heading: Platform
+    description: "Enable teams with enterprise automation, collaboration, and internal developer platforms"
+    link: /docs/platform/
+  - heading: Management
+    description: "Discover, govern, and optimize cloud infrastructure with AI-powered insights and compliance"
+    link: /docs/management/
+  - heading: Developer Tools
+    description: "CLIs, SDKs, APIs, and AI-powered development tools for infrastructure as code"
+    link: /docs/pulumi-cli/
 - type: cards-logo-label-link
   heading: Clouds
   description: <p>Pulumi IaC supports AWS, Azure, Google Cloud, Kubernetes, and <a href="/registry/">120+ packages</a>.</p>

content/docs/build/_index.md

@@ -0,0 +1,105 @@
+---
+title: Build
+linktitle: Build
+capability: build
+docs_home: true
+notitle: true
+no_on_this_page: true
+expanded_menu_ids:
+    - build-core-concepts
+    - build-languages
+    - build-cloud-platforms
+menu:
+    build:
+        identifier: build-home
+        weight: 1
+meta_desc: Build and deploy cloud infrastructure with Pulumi. Manage stacks, environments, resources, and services for your daily engineering work.
+meta_image: /images/docs/meta-images/docs-meta.png
+h1: <strong>Build</strong> with Pulumi
+description: <p>Everything you need for daily engineering work - creating stacks, managing environments, deploying resources, and building cloud services.</p>
+
+sections:
+- type: full-width-cards
+  heading: Core Building Blocks
+  cards:
+  - icon: 📚
+    heading: Stacks
+    description: Create and manage isolated deployments of your infrastructure across environments.
+    link: /docs/iac/concepts/stacks/
+  - icon: ⚙️
+    heading: Configuration & Secrets
+    description: Configure secrets, settings, and variables across your infrastructure and applications.
+    link: /docs/build/configure-secure/
+  - icon: 🧱
+    heading: Resources
+    description: Provision and manage cloud resources with infrastructure as code.
+    link: /docs/iac/concepts/resources/
+  - icon: 🤖
+    heading: Tasks
+    description: AI-powered infrastructure generation, optimization, and intelligent assistance.
+    link: /docs/ai/
+
+
+- type: full-width-cards
+  heading: Essential Build Tasks
+  cards:
+  - icon: 🚀
+    heading: Deploy Your First Stack
+    description: Learn the fundamentals of creating and deploying infrastructure stacks.
+    link: /docs/iac/get-started/
+  - icon: 🔐
+    heading: Manage Secrets & Config
+    description: Securely handle configuration and secrets across environments.
+    link: /docs/esc/get-started/
+  - icon: ☁️
+    heading: Connect to Cloud Services
+    description: Build applications that integrate with cloud databases, storage, and APIs.
+    link: /docs/iac/concepts/
+  - icon: 📋
+    heading: Organize Stacks
+    description: Structure your infrastructure across development, staging, and production.
+    link: /docs/pulumi-cloud/projects-and-stacks/
+
+- type: cards-logo-label-link
+  heading: Build in Your Language
+  description: Use familiar programming languages for infrastructure as code.
+  cards:
+  - label: TypeScript/JavaScript
+    icon: icon-32-32 node-color-32-32
+    link: /docs/iac/languages-sdks/javascript/
+  - label: Python
+    icon: icon-32-32 python-color-32-32
+    link: /docs/iac/languages-sdks/python/
+  - label: Go
+    icon: icon-32-32 go-color-32-32
+    link: /docs/iac/languages-sdks/go/
+  - label: .NET
+    icon: icon-32-32 dotnet-color-32-32
+    link: /docs/iac/languages-sdks/dotnet/
+  - label: Java
+    icon: icon-32-32 java-color-32-32
+    link: /docs/iac/languages-sdks/java/
+  - label: YAML
+    icon: icon-32-32 yaml-color-32-32
+    link: /docs/iac/languages-sdks/yaml/
+
+- type: cards-logo-label-link
+  heading: Get Started Building
+  description: Jump into creating infrastructure on your preferred cloud platform.
+  cards:
+  - label: AWS Quick Start
+    icon: aws-40
+    link: /docs/iac/get-started/aws/
+  - label: Azure Quick Start
+    icon: azure-40
+    link: /docs/iac/get-started/azure/
+  - label: Google Cloud Quick Start
+    icon: google-cloud-40
+    link: /docs/iac/get-started/gcp/
+  - label: Kubernetes Quick Start
+    icon: kubernetes-40
+    link: /docs/iac/get-started/kubernetes/
+- type: flat
+  heading: Ready to build?
+  description: <p>Start with our <a href="/docs/iac/get-started/">Get Started guide</a>, explore <a href="/tutorials/">tutorials</a>, or jump into <a href="/docs/esc/get-started/">environment configuration</a>. Need help? Join us on <a href="https://slack.pulumi.com" target="_blank">Slack</a> or <a href="/support/">contact support</a>.</p>
+---

content/docs/build/advanced-concepts.md

@@ -0,0 +1,39 @@
+---
+title: Advanced Concepts
+h1: Advanced Concepts
+capability: build
+menu:
+    build:
+        name: Advanced Concepts
+        identifier: build-advanced-concepts
+        parent: build-core-concepts
+        weight: 50
+meta_desc: Advanced concepts for building infrastructure with Pulumi - functions, dynamic providers, and resource naming.
+meta_image: /images/docs/meta-images/docs-meta.png
+---
+
+Advanced concepts for taking your infrastructure further with Pulumi.
+
+## Tasks
+
+Use AI to generate, modify, and optimize infrastructure code:
+
+- **[Pulumi AI](/ai/)** - Natural-language tasks for scaffolding and evolving IaC
+
+## Functions
+
+Invoke cloud provider functions and utilities:
+
+- **[Functions](/docs/iac/concepts/functions/)** - Invoke cloud provider functions to get data and resources
+
+## Dynamic Providers
+
+Create custom resource providers:
+
+- **[Dynamic Providers](/docs/iac/concepts/resources/dynamic-providers/)** - Create custom resource providers for unique use cases
+
+## Resource Management
+
+Advanced resource management concepts:
+
+- **[Resource Names](/docs/iac/concepts/resources/names/)** - Understanding how Pulumi names resources