Skip to content

fix(DOC-1958): add lifecycle ignore_changes guidance and prose cleanup#533

Open
mfernest wants to merge 1 commit intomainfrom
fix/doc-1958-terraform-ignore-changes
Open

fix(DOC-1958): add lifecycle ignore_changes guidance and prose cleanup#533
mfernest wants to merge 1 commit intomainfrom
fix/doc-1958-terraform-ignore-changes

Conversation

@mfernest
Copy link
Contributor

@mfernest mfernest commented Mar 19, 2026

Summary

  • Documents the lifecycle { ignore_changes = [throughput_tier] } pattern as a complement to allow_deletion = false, protecting clusters from accidental replacement when Redpanda Support upgrades a throughput tier
  • Rewrites opening sentence to remove weak verbs
  • Cuts throat-clearing prose throughout (~234 net word reduction)
  • Fixes passive voice, future tense, e.g./etc., and Title Case violations
  • Tightens callout <1> from 9 sentences to 3
  • Replaces "your-secret-password" placeholder with "schema-registry-password"

Resolves DOC-1958.

Test plan

  • Build passes locally
  • Limitations section renders correctly with new lifecycle code block
  • Deploy preview renders correctly

🤖 Generated with Claude Code

- Add lifecycle block example for throughput_tier to prevent accidental
  cluster replacement when Redpanda Support upgrades a cluster
- Rewrite opening sentence to remove weak verbs
- Cut throat-clearing prose throughout (234 net word reduction)
- Fix passive voice, future tense, e.g./etc., and Title Case violations
- Tighten callout <1> from 9 sentences to 3
- Replace placeholder "your-secret-password" with "schema-registry-password"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mfernest mfernest requested a review from a team as a code owner March 19, 2026 19:50
@netlify
Copy link

netlify bot commented Mar 19, 2026

Deploy Preview for rp-cloud ready!

Name Link
🔨 Latest commit cc47d06
🔍 Latest deploy log https://app.netlify.com/projects/rp-cloud/deploys/69bc53a399f9a50008e4b2d9
😎 Deploy Preview https://deploy-preview-533--rp-cloud.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 19, 2026

📝 Walkthrough

Walkthrough

This pull request updates the Terraform provider documentation file with refined phrasing, improved capitalization consistency, and clarified technical content. Changes include replacing placeholder credentials with more generic equivalents, expanding the throughput_tier warning with a Terraform lifecycle workaround example, refining installation instructions, and reworded descriptions for various examples and Terraform concepts.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

Suggested reviewers

  • micheleRP
  • david-yu
  • paulohtb6
🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Description check ❓ Inconclusive The description covers key objectives and includes a test plan, but deviates from the repository's required template structure by missing explicit page previews and checkbox selections. Follow the repository template: add page preview links and mark the appropriate checkbox (likely 'Small fix') to fully comply with documentation standards.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically summarizes the main changes: documenting a Terraform lifecycle pattern and performing prose cleanup, aligning with the primary objectives.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/doc-1958-terraform-ignore-changes
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@modules/manage/pages/terraform-provider.adoc`:
- Line 660: Update the NOTE that currently reads "Terraform deletes a cluster
that depends on a network after it deletes the network" to correctly state
deletion order for dependent resources: the dependent resource (cluster) is
destroyed first, then its dependency (network). Locate the note text string
"NOTE: Terraform deletes dependent resources in the correct order. For example,
Terraform removes a cluster that depends on a network after it deletes the
network." and rephrase it so the example reads that Terraform removes the
cluster first and then the network.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e2a15053-62d3-4632-a437-bf3a32c50aa7

📥 Commits

Reviewing files that changed from the base of the PR and between d122be8 and cc47d06.

📒 Files selected for processing (1)
  • modules/manage/pages/terraform-provider.adoc

The `terraform destroy` command deletes all resources defined in your configuration.

NOTE: Terraform ensures that dependent resources are deleted in the correct order. For example, a cluster dependent on a network will be removed after the network.
NOTE: Terraform deletes dependent resources in the correct order. For example, Terraform removes a cluster that depends on a network after it deletes the network.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Fix reversed dependency deletion order in the note.

Line 660 currently says Terraform deletes the network before the dependent cluster. That order is backward. For dependent resources, Terraform destroys the dependent resource first (cluster), then the dependency (network).

✏️ Proposed wording fix
-NOTE: Terraform deletes dependent resources in the correct order. For example, Terraform removes a cluster that depends on a network after it deletes the network.
+NOTE: Terraform deletes dependent resources in the correct order. For example, Terraform removes a cluster that depends on a network before it deletes the network.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@modules/manage/pages/terraform-provider.adoc` at line 660, Update the NOTE
that currently reads "Terraform deletes a cluster that depends on a network
after it deletes the network" to correctly state deletion order for dependent
resources: the dependent resource (cluster) is destroyed first, then its
dependency (network). Locate the note text string "NOTE: Terraform deletes
dependent resources in the correct order. For example, Terraform removes a
cluster that depends on a network after it deletes the network." and rephrase it
so the example reads that Terraform removes the cluster first and then the
network.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant