-
Task
-
Resolution: Unresolved
-
Major
-
None
-
None
-
8
-
Documentation (Ref Guide, User Guide, etc.)
-
---
-
---
You can see two PRs listed in the description. All of the SME, QE, and peer-review comments are included in the Original PR. As we were unable to continue working on the Original PR, the Second PR was created specifically to address the peer-review comments.
Original PR that has peer-review comments: https://github.com/openshift/openshift-docs/pull/53813
Comments we need to address?
- https://github.com/openshift/openshift-docs/pull/53813#discussion_r1139716342
- https://github.com/openshift/openshift-docs/pull/53813#discussion_r1138684902
- https://github.com/openshift/openshift-docs/pull/53813#discussion_r1138770368
- https://github.com/openshift/openshift-docs/pull/53813#discussion_r1138777991
What do we need to do?
For all the links mentioned above, consider moving the content into modules and additional references. This will help stick to the writing guidelines and standards.
Points to consider:
- The procedure can only have 3 levels. Please fix wherever you see similar occurrences and fix them in this PR.
- As per the Red Hat style guide: You can nest lists, but try to keep the number of levels to two or fewer.
- IBM style guide: Avoid writing excessively long procedures. Try to break up long procedures into smaller tasks. Procedural steps should have no more than two levels; restructure the information instead.
Second PR that got created when addressing the remaining peer-review comments: https://github.com/openshift/openshift-docs/pull/57455