OSDOCS-16950#CQA work Stor6 - LVMS installation

[lpettyjo]

Split from #115159. CQA updates for LVMS installation modules.

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

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

[ocpdocs-previewbot]

🤖 Wed Aug 05 16:57:20 - Prow CI generated the docs preview:

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

[cbippley]

/label merge-review-in-progress

[cbippley]

Review Guide — OSDOCS-16950 LVMS Installation CQA

Summary: CQA improvements across 8 LVMS installation files — adds [role="_abstract"] tags, replaces numbered callouts with definition lists, improves short descriptions, removes extra blank lines, and standardizes cross-references.

Changes at a Glance

Change Type	Count	Details
Added [role="_abstract"]	5 modules	About, disconnected, CLI, web console, RHACM install
Callouts → definition lists	2 files	lvms-creating-lvmcluster, lvms-disconnected-ImageSetConfig
Short description rewrites	5 modules	More actionable, task-oriented language
Hardcoded "OpenShift" → {product-title}	1 module	external-auth-disabling replaced with attribute
RHACM callout removal	1 module	Removed numbered callouts <1>–<4>, replaced with bullet list
Formatting cleanup	4 files	Removed extra blank lines before .Prerequisites/.Procedure

Step-by-Step Visual Review

All changes render on a single page. Open the base URL, then use anchors to jump to each section:

Base URL: persistent-storage-using-lvms.html

#	Section	What to Check	Preview Link
1	About LVMS installation	Abstract tag renders, updated cross-ref text	About
2	Install via CLI	Abstract renders, no extra whitespace	CLI install
3	Install via web console	Abstract renders, .Verification label (not .Verification steps)	Web console
4	Install via RHACM	Abstract renders, callouts replaced with bullet list, YAML clean	RHACM
5	Disconnected install	Abstract renders, cross-ref text cleaned up, no "section" suffix	Disconnected
6	Creating LVMCluster (snippet)	Callouts replaced with trailing sentence listing optional fields	LVMCluster CR
7	ImageSetConfiguration (snippet)	Callouts replaced with definition list, all 9 fields described	ImageSetConfig
8	Static mode enforcement	Reworded abstract, no content loss	Static mode

Quick Checklist

• All [role="_abstract"] sections render correctly (no raw markup visible)
• Callout replacements in RHACM YAML display as a clean bullet list
• ImageSetConfiguration snippet shows definition list instead of numbered callouts
• LVMCluster snippet trailing sentence renders (not raw AsciiDoc)
• No broken cross-references or missing content
• Formatting is consistent (no extra blank lines between sections)

[cbippley]

Some blockers found, fix and merge.

[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: #117399

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: #117400

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.