Add cloud-agnostic getting-started overview and connect-cloud page#20428
Add cloud-agnostic getting-started overview and connect-cloud page#20428CamSoper wants to merge 2 commits into
Conversation
|
Your site preview for commit ff3f937 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-20428-ff3f937d.s3-website.us-west-2.amazonaws.com Changed pages: |
Pre-merge Review — Last updated 2026-07-24T22:56:38ZTip Summary: This PR adds a cloud-agnostic getting-started overview to Review confidence:
Investigation log
🔍 Verification trail44 claims extracted · 33 verified · 4 unverifiable · 0 contradicted
🚨 Outstanding in this PRNo blocking issues found.
|
|
@claude #update-review — b63fa06 addresses both low-confidence findings: the stepper sentence now refers unambiguously to the per-cloud configure pages, and Next steps no longer uses the per-cloud "step 3" numbering. Generated by Claude Code |
|
🤖 Review updated on @CamSoper's request. |
Rebuild /docs/get-started/ as an end-to-end overview: a light "Why Pulumi" value-prop section, a five-step journey (install, connect your cloud account, write a program, deploy, iterate) with a Mermaid flowchart, the existing cloud fan-out cards, and a link to the previously orphaned Pulumi for Terraform Users flow. Add /docs/get-started/connect-cloud/, a generic credentials explainer targeting the funnel's biggest dropoff step: Pulumi has no credential system of its own and uses your cloud CLI's existing credentials. Includes an identity-check command table and a card fan-out into each cloud's existing configure-access page (new data-track values so landing-page analytics stay clean), plus the ESC OIDC best-practice pointer. Per-cloud flows, layouts, and nav data files are intentionally untouched; a follow-up PR will consolidate the near-identical flow steps into shortcodes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFeRMk9djuoDMn83d4wZ4v
Reword the stepper description so it clearly refers to the per-cloud configure pages rather than this page, and drop the per-cloud "step 3" numbering from Next steps to avoid clashing with the overview's five-step model. Co-Authored-By: Claude <noreply@anthropic.com>
b63fa06 to
ff3f937
Compare
|
@claude #update-review — rebased onto master to clear the merge conflict (kept master's "Learn more" heading rename alongside this PR's Terraform-users link; branch is now Generated by Claude Code |
|
🤖 Review updated on @CamSoper's request. |
Proposed changes
Out of a UX-crit discussion (Slack thread): the getting-started funnel had no cloud-agnostic end-to-end explanation, and the "configure credentials" step is our biggest dropoff with only cloud-specific pages.
1. Rebuilt
/docs/get-started/landing page (content/docs/get-started/_index.md)/what-is/what-is-pulumi/)data-trackvalues, icons, and markup)meta_desconly)2. New
/docs/get-started/connect-cloud/page (content/docs/get-started/connect-cloud.md)A generic credentials explainer targeting the dropoff step. Leads with the key reassurance — Pulumi has no credential system of its own; it uses your cloud CLI's existing credentials — then:
aws sts get-caller-identity,az account show,gcloud config list,kubectl cluster-info) matching the commands the per-cloud configure pages useconfigurestep, with newdata-trackvalues (connect-*-configure) so landing-page analytics stay cleanJoins the left nav under Getting Started via frontmatter only — no
layouts/ordata/changes, no changes to the per-cloud flows. A follow-up PR will consolidate the near-identical per-cloud flow steps into shortcodes.Verification: markdown lint passes (0 errors), prettier clean; per-cloud configure targets and stepper untouched.