Skip to content

[OSDOCS#16812]:Updated the Deleting your cluster assembly_CQA jobs#108791

Open
jheraght wants to merge 1 commit intoopenshift:mainfrom
jheraght:OSDOCS-16812
Open

[OSDOCS#16812]:Updated the Deleting your cluster assembly_CQA jobs#108791
jheraght wants to merge 1 commit intoopenshift:mainfrom
jheraght:OSDOCS-16812

Conversation

@jheraght
Copy link
Contributor

@jheraght jheraght commented Mar 20, 2026

Version(s):
4.20+

Issue:
https://redhat.atlassian.net/browse/OSDOCS-16812

Link to docs preview:
Deleting your cluster

Peer review:

  • Peer reviewer has approved this change.

QE review:

  • QE approval not required as no procedural changes.

Additional information:

@openshift-ci openshift-ci bot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Mar 20, 2026
@ocpdocs-previewbot
Copy link

@openshift-ci
Copy link

openshift-ci bot commented Mar 20, 2026

@jheraght: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

toc::[]
[role="_abstract"]
You can delete your {product-title} cluster using either the {rosa-cli-first} or the user interface (UI).
You might want to delete your {product-title} cluster in certain situations, such as if it fails to install properly, encounters errors during provisioning, or if it was set up for testing purposes only. You can delete your cluster using either the {rosa-cli-first} or the user interface (UI).
Copy link
Contributor

Choose a reason for hiding this comment

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

That's a great rewrite that adds the why. My suggestion to cut things out is for these reasons:

  • "in certain situations, such as" gives a nice flow, yet it can be removed without loosing a lot of meaning: "You might want to delete a cluster if it fails to..." That would create an even more concise doc.

  • There's kinda an unspoken rule that in docs we focus on normal operation of products and avoid mentioning less typical outcomes like faulty behaviour and failure scenarios. We kinda “reserve negativity” for special cases docs where mentioning bugs and disaster events is unavoidable like in troubleshooting guides. This assembly can remain helpful without reminding users that our products can fail. If that makes sense. I'm open to discuss that further here or in Slack.

  • Phrasal verbs are frowned upon, and set up can be replaced with create. On the other hand, set up is very common in tech docs and won't confuse anyone, we could as well keep it.

Suggested change
You might want to delete your {product-title} cluster in certain situations, such as if it fails to install properly, encounters errors during provisioning, or if it was set up for testing purposes only. You can delete your cluster using either the {rosa-cli-first} or the user interface (UI).
You might want to delete your {product-title} cluster if you created it for testing purposes only or no longer need it for other reasons. You can delete your cluster using either the {rosa-cli-first} or the user interface (UI).

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

Labels

size/XS Denotes a PR that changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants