OSDOCS-16950#CQA work Stor6 - LVMS LVMCluster CR

[lpettyjo]

Split from #115159. CQA updates for LVMS LVMCluster CR, creating, and deleting modules.

https://issues.redhat.com/browse/OSDOCS-16950

Dear reviewer, please check the assembly file as well (#116579).

[ocpdocs-previewbot]

🤖 Tue Aug 04 23:39:46 - Prow CI generated the docs preview:

https://116573--ocpdocs-pr.netlify.app/openshift-enterprise/latest/storage/persistent_storage_local/persistent-storage-using-lvms.html

[cbippley]

/label merge-review-in-progress
/remove-label merge-review-needed

[cbippley]

Review Guide — OSDOCS-16950 CQA: LVMS LVMCluster CR

Preview base: persistent-storage-using-lvms.html

Summary of changes (14 files)

Category	What changed
Abstract blocks	Added [role="_abstract"] with action-oriented intro sentences to 10 modules
Callout → definition list	Replaced numbered callouts (<1>, <2>, …) with inline * spec.field: definition-list format across 6 files
External links	Converted bare link:https://...[] references to plain-text titles (RHEL docs for RAID, LVM tags, persistent naming)
Whitespace / formatting	Removed blank lines after .Prerequisites, .Procedure, .Verification headings; fixed "failue" → "failure" typo
Section ID added	New [id="about-lvmcluster-exaplain-fields_{context}"] on "Explanation of fields" subsection
Optional → required steps	Two verification steps changed from "Optional:" to required in CLI create module
Reuse VG verification	Converted [NOTE] block into a proper .Verification section

Quick visual review checklist

Click each link → scan for correct rendering → check no broken formatting.

#	Section	Preview link
1	About the LVMCluster CR	View
2	Explanation of fields table	View
3	Ways to create an LVMCluster CR	View
4	Creating LVMCluster by CLI	View
5	Creating LVMCluster by web console	View
6	Creating LVMCluster by RHACM	View
7	About adding devices to a VG	View
8	About removing devices from VG	View
9	Devices not supported by LVMS	View
10	Reusing a VG from previous install	View
11	Ways to delete an LVMCluster CR	View
12	Deleting LVMCluster by CLI	View
13	Deleting LVMCluster by web console	View
14	Deleting LVMCluster by RHACM	View
15	Deleting an LVM cluster (gate)	View

What to look for

• Abstract text renders correctly (not raw [role="_abstract"])
• Definition lists (* spec.field:) display properly — no stray asterisks or broken formatting
• External link text appears as plain titles (no bare URLs visible)
• Code blocks still have correct syntax highlighting
• No orphaned callout numbers (<1>, <2>, etc.) remain
• Verification sections render with proper heading structure
• New section ID about-lvmcluster-exaplain-fields anchor works

[cbippley]

Some nits to fix before merging.

[cbippley]

/remove-label merge-review-in-progress

[openshift-ci]

@lpettyjo: 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.

[lpettyjo]

/cherrypick enterprise-5.0

[lpettyjo]

/cherrypick enterprise-4.22

[openshift-cherrypick-robot]

@lpettyjo: new pull request created: #117397

Details

In response to this:

/cherrypick enterprise-5.0

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.

[openshift-cherrypick-robot]

@lpettyjo: new pull request created: #117398

Details

In response to this:

/cherrypick enterprise-4.22

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.