OSDOCS-16948#CQA work Stor4 - vSphere CSI driver

[lpettyjo]

Version(s): 4.20+

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

Link to docs preview: https://114546--ocpdocs-pr.netlify.app/openshift-enterprise/latest/storage/container_storage_interface/persistent-storage-csi-vsphere.html

QE review:

• QE has approved this change.

Additional information:

[ocpdocs-previewbot]

🤖 Wed Jul 29 01:14:19 - Prow CI generated the docs preview:

https://114546--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/installing_vsphere/ipi/ipi-vsphere-installation-reqs.html
https://114546--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/installing_vsphere/upi/upi-vsphere-installation-reqs.html
https://114546--ocpdocs-pr.netlify.app/openshift-enterprise/latest/storage/container_storage_interface/persistent-storage-csi-snapshots.html
https://114546--ocpdocs-pr.netlify.app/openshift-enterprise/latest/storage/container_storage_interface/persistent-storage-csi-vsphere.html

[stevsmit]

I quit reviewing this in modules/persistent-storage-csi-vsphere-overview.adoc because there's just a lot of errors that appear to be done by AI, such as lack of IDs, sections titled "Overview" etc, which aren't compliant with either IBMSG or RHSSG or OSDOCS guidelines. This is a common problem across multiple PRs.

AI is an OK tool, but the outputs have to be validated and made compliant with our rules.

[lpettyjo]

@stevsmit PTAL. Addressed comments. FYI, content was not created by AI.

[cbippley]

/label merge-review-in-progress

[cbippley]

/remove-label merge-review-needed

[cbippley]

Visual Review Guide — OSDOCS-16948

Summary: CQA rework of 24 vSphere CSI driver docs. Extracts overview and encryption content into standalone modules, adds abstracts, converts callouts to inline descriptions, and restructures the assembly.

Quick Navigation

Base URL: https://114546--ocpdocs-pr.netlify.app/openshift-enterprise/latest

Main Assembly (start here)

Section	Preview Link
Overview (new module)	persistent-storage-csi-vsphere.html#overview
Limitations	#limitations
Storage policy	#stor-policy
ReadWriteMany	#rwx
Driver requirements	#csi-driver-reqs
Remove third-party driver	#install-issues

Encryption

Section	Preview Link
Encryption overview (new module)	#encryption
Datastore URL method	#encryption-datastore-url
Tag-based placement	#encryption-tag-based

Topology-Aware Provisioning

Section	Preview Link
Topology overview	#top-aware-overview
During installation	#top-aware-during-install
Post-installation	#top-aware-post-install
Infrastructure topology	#top-aware-infra-top
Verify results	#top-aware-results

Other Sections

Section	Preview Link
Multi-vCenter overview	#multi-vcenter-overview
Migrating CNS volumes	#migrating-cns-vols
Disable/enable storage	#disable-storage-overview
Bare-metal nodes	#adding-bm-nodes
Increase max volumes	#increase-max-vols

Install Requirement Pages (shared module)

Page	Preview Link
IPI install reqs	ipi-vsphere-installation-reqs.html#csi-driver-reqs
UPI install reqs	upi-vsphere-installation-reqs.html#csi-driver-reqs

Review Checklist

• Overview module: New standalone module — verify content renders correctly and abstracts display
• Encryption section: New concept module extracted from assembly — check two sub-procedures (datastore URL, tag-based) still flow logically
• Topology sections: Verify YAML examples render (callouts removed, inline descriptions added)
• Install-issues module: Content type changed CONCEPT → PROCEDURE — verify structure
• IPI/UPI install pages: Shared vmware-csi-driver-reqs module — confirm it renders in both contexts

[cbippley]

Some changes needed. Once they are fixed you can merge.

[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

[lpettyjo]

/cherrypick enterprise-4.21

[openshift-cherrypick-robot]

@lpettyjo: #114546 failed to apply on top of branch "enterprise-5.0":

Patch is empty.
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To record the empty patch as an empty commit, run "git am --allow-empty".
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config set advice.mergeConflict false"

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

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.

[openshift-cherrypick-robot]

@lpettyjo: new pull request created: #116775

Details

In response to this:

/cherrypick enterprise-4.21

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.