Description of problem:
Version-Release number of selected component (if applicable):
OCP 4.9.0-0.nightly-2021-09-10-170926 and ODF 4.9.0-139.ci
Steps to Reproduce:
On the Overview tab under `Home', click on View all quick starts on Build with guided documentation tile.
GUIDE 1- Install the OpenShift Data Foundation
Install the OpenShift Data Foundation 1 of 2
Check your work
I don't see any verification steps mentioned currently, it is just asking for user input in the form of Yes/No.
Can we please add a small and simple verification step that will help the user while repeating the installation steps again? I know there can be several reasons for failure, but can we add something which is very generic and may help users to keep that in mind while repeating the installation.
Create a StorageSystem 2 of 2
3rd bullet point in under point 5 isn't very clear or self-explanatory and should be rephrased to:
Bullet point heading: Create a new storage class using an external storage array
It's description: Can be used on bare-metal infrastructures where nodes have access to the external storage array (e.g. via Fibre Channel or iSCSI). The infrastructure storage class is provided by a third-party CSI driver leveraging the external storage array (e.g. IBM Block CSI Driver). Important: The CSI driver must support block mode for the block devices it provisions.
These statements are suggested by @jelopez
Please re-phrase it (if needed) so as to make it more short and precise and to better fit UI.
Check your work
Again, if we can add a genric, small, and simple step for the user to keep in mind while repeating the StorageSystem creation steps.
Few steps are missing. Some of the statements have grammatical mistakes. I also see scope to make this guide more user-friendly.
All the possible details are provided along with each issue mentioned above.
Additional info: Please refer https://bugzilla.redhat.com/show_bug.cgi?id=2004916 for more clarification and discussion around this issue.
Fix for #2004916 was across two repos, one is "odf-operator" and other to "console-operator".
So, #2004916 will handle fixes in "Getting Started" & "Configure and Management" guides and this new BZ will handle fixes in "Install" ODF guide.
Checked on ocp 4.10 cluster with payload 4.10.0-0.nightly-2021-10-31-133814. Updates look good except this sentence "Once your StorageSystem’s reaches a Ready status", seems a grammar error, should it be "Once your StorageSystem reaches a Ready status"?
Checked on ocp 4.10 cluster with payload 4.10.0-0.nightly-2021-11-03-181048, the grammar error has been fixed.
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.
For information on the advisory (Moderate: OpenShift Container Platform 4.10.3 security update), and where to find the updated
files, follow the link below.
If the solution does not work for you, open a new bug report.