Document and announce ESC deletion protection feature

[fnune]

Proposed changes

Adds documentation for the deletion protection feature in Pulumi ESC and a blog post announcing its availability.

The deletion protection feature prevents accidental deletion of environments by requiring that protection be explicitly disabled before deletion. This helps safeguard production environments and shared configuration.

Changes:

• Add deletion protection documentation page in administration section
• Update administration index to include deletion protection
• Create blog post announcing the feature

Related issues (optional)

Fixes: https://github.com/pulumi/pulumi-service/issues/33815

[claude]

Review Summary

This PR adds documentation and a blog post for the ESC deletion protection feature. The content is well-structured and mostly follows the style guide, but there are several issues that need to be addressed before merging.

---

Critical Issues

Missing more break in blog post

File: content/blog/esc-deletion-protection/index.md:17

The blog post is missing the more break after the first paragraph. According to BLOGGING.md, this is required to control what appears on the blog home page. Add this HTML comment after line 15.

---

Style Issues

1. Improper heading capitalization in blog post

File: content/blog/esc-deletion-protection/index.md

According to STYLE-GUIDE.md, H2 and deeper headings should use sentence case, not title case.

Line 21: Change to "How it works"
Line 26: Change to "Managing deletion protection"
Line 44: Change to "When to use deletion protection"
Line 58: Change to "Getting started"

2. Improper heading capitalization in documentation

File: content/docs/esc/administration/deletion-protection.md

Multiple headings use title case instead of sentence case:

Line 14: "Enabling deletion protection"
Line 43: "Deleting protected environments"
Line 58: "Visual indicators"
Line 67: "Use cases"

3. Missing blank line before heading

File: content/blog/esc-deletion-protection/index.md:30

According to STYLE-GUIDE.md, headings should be surrounded by blank lines. Add a blank line before line 30.

4. Navigation terminology

File: content/blog/esc-deletion-protection/index.md:28

According to STYLE-GUIDE.md, use "navigate" not "navigate to".

Change: "In the Pulumi Cloud console, navigate to your environment's settings"

---

Content Suggestions

1. Blog post author - Line 8: The author is set to "pulumi" which is generic. Consider using a specific author ID.

2. Blog post opening hook - Line 15: The opening is functional but could be more engaging.

3. Missing file endings - Both new markdown files should end with a newline.

---

Positive Observations

• Clear and concise documentation structure
• Good use of code examples with bash syntax highlighting
• Appropriate cross-linking between blog post and documentation
• Visual indicators section is helpful for users
• Permissions section clearly explains admin requirements
• Use cases are practical and relevant

---

Checklist Before Merge

• Add more break to blog post after first paragraph
• Fix all heading capitalization (sentence case for H2+)
• Add blank line before Managing deletion protection heading
• Fix navigate to
• Verify both files end with newlines
• Test meta.png preview on blog home page
• Verify internal link resolves correctly

---

Mention @claude if you would like me to review again after making changes or if you need help with any of these suggestions.

[fnune]

What's the process here? Do we get a new image for this, or is this one OK?

[CamSoper]

Yikes. I didn't even know this was there.

Did this come from the blog template? Maybe we should ask the marketing folk to make us one for blogs.

[CamSoper]

But I'm fine with running with this one for the moment, since I'm sure we have a bunch of blog posts using it.

[pulumi-bot]

Your site preview for commit 1792e40 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-16334-1792e40f.s3-website.us-west-2.amazonaws.com.

[pulumi-bot]

Your site preview for commit e9767dd is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-16334-e9767dda.s3-website.us-west-2.amazonaws.com.