content(what-is): expand the cloud security explainer#19141
Conversation
Rewrites content/what-is/what-is-cloud-security.md from a general overview into a deeper page modeled on the same template as the recent IaC and DevOps rewrites. New structure: - Bold quotable definition + question-driven TOC. - "Why does cloud security matter?" with three drivers (attack surface, misconfiguration, regulation). - On-premises vs. cloud comparison table. - Shared responsibility model as an IaaS/PaaS/SaaS table. - CIA triad and the related principles (defense in depth, least privilege, zero trust, secure by default). - Six security domains (IAM, data, network, app/workload, posture, detection/response). - Top-10-style risk list keyed to OWASP Cloud-Native and CSA Top Threats categories. - Nine concrete best practices with internal links to IaC, ESC, CrossGuard, and components. - Section on how IaC and policy as code reduce cloud-security risk. - Ten FAQ entries (doubt-removers: shared responsibility, common breach causes, CSPM, zero trust, getting-started checklist). - Learn-more cross-links to IaC, secrets management, configuration management, SOC 2, HIPAA, HITRUST. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
Your site preview for commit 92d0ef1 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-19141-92d0ef1b.s3-website.us-west-2.amazonaws.com |
|
@claude - review this pr please |
|
Claude finished @alexleventer's task in 2m 15s —— View job PR Review: content(what-is): expand the cloud security explainerTasks:
SummaryScope: This is a strong rewrite. The document is significantly more practical, technically precise, and well-structured than what it replaces. The comparison tables, shared responsibility model breakdown, and CIA triad section are all good additions. The meta description is much better for SEO. Internal links are correct and all linked pages exist. One must-fix issue (duplicate heading anchor) and a few low-confidence style nits below.
🚨 Must fixDuplicate heading slug — anchor collision (lines 57 and 169) The H2 on line 57 and the H3 on line 169 both read exactly Suggested fix — rename the FAQ question to something distinct, or collapse it into an adjacent answer: Current (line 169): ### What is the shared responsibility model?Suggested: ### How does the shared responsibility model split duties?Or simply remove the FAQ entry since the dedicated H2 section at line 57 answers this comprehensively. Fix this →
|
|
@claude #new-review |
Pre-merge Review — Last updated 2026-05-19T16:35:00ZTip Summary: This PR rewrites the Review confidence:
Investigation log
🔍 Verification trail30 claims extracted · 23 verified · 4 unverifiable · 0 contradicted
🚨 Outstanding in this PRNo outstanding issues.
|
|
🤖 Review regenerated on @CamSoper's request. |
|
@claude - fix all the outstanding items and then #update-review |
- Replace legacy "Pulumi CrossGuard" name with current "Pulumi Policies" at all four occurrences (best practices, IaC section, FAQ checklist) - Reframe Pulumi ESC as the aggregator layer over HashiCorp Vault and AWS Secrets Manager rather than a co-equal peer Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
🤖 Review updated on @alexleventer's request. |
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
🤖 Review updated on @CamSoper's request. |
Summary
Rewrites
content/what-is/what-is-cloud-security.mdfrom a general overview into a deeper, more practical explainer that engineers and security teams can actually use as a reference. Body grows from ~280 lines to ~140 well-structured lines.What changed
Test plan
make serve; visit/what-is/what-is-cloud-security/and confirm tables, headings, and internal links render correctly/what-is/what-is-soc-2/,/product/esc/,/docs/insights/policy/, etc.)🤖 Generated with Claude Code