Add "What Is Infrastructure Drift?" explainer#20098
Conversation
New what-is page covering infrastructure drift: the three-state model (desired/current/actual), causes (human out-of-band vs. automated cloud-side changes), why it matters, detection with preview-only refresh, the remediation-vs-adoption reconciliation directions, prevention levers, and how Pulumi handles it end to end (CLI, Deployments, resource options, policy, Neo-assisted adoption). Grounded in the Detecting and reconciling drift docs. Adds reciprocal links from the policy-as-code and agentic-infrastructure explainers so the four related pages interlink. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
Your site preview for commit 896f60f is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-20098-896f60f1.s3-website.us-west-2.amazonaws.com |
Pre-merge Review — Last updated 2026-07-06T23:46:25ZTip Summary: This PR adds a new Review confidence:
Investigation log
🔍 Verification trail96 claims extracted · 86 verified · 2 unverifiable · 3 contradicted
|
🚨 Outstanding in this PRNo outstanding issues in this PR.
|
Proposed changes
Adds a new
/what-is/explainer, What Is Infrastructure Drift?, filling a conspicuous gap: drift is a top-of-funnel concept and a core Pulumi differentiator, but nothing in/what-is/covered it despite dedicated docs and three blog posts on the topic.The page walks a reader from definition to action:
--expect-no-changesas a CI signal, and scheduled/managed detection.ignoreChanges,protect, components/IDP golden paths, policy that survives adoption, and continuous GitOps reconciliation with its real limits.Everything is grounded in the existing Detecting and reconciling drift docs, with links out to the relevant CLI, Deployments, resource-option, and policy pages.
It also adds two reciprocal links — from the policy-as-code and agentic-infrastructure explainers — so the four related pages interlink instead of the new one sitting orphaned.
Related issues (optional)
None.