Bug 1526428

Document URL: 

https://access.redhat.com/documentation/en-us/openshift_container_platform/3.7/html-single/installation_and_configuration/#inital-planning

Section Number and Name: 

Section 2.1.1 Initial Planning

Describe the issue: 

Sizing Considerations is listed after Environment Scenarios in the bullet list.  However, Environment Scenarios depends on Sizing Considerations (e.g. https://access.redhat.com/documentation/en-us/openshift_container_platform/3.7/html-single/installation_and_configuration/#environment-scenarios states "Use these scenarios as a basis for planning your own OpenShift Container Platform cluster, based on your sizing needs.")

Further, Section 2.1.3 Sizing Considerations is before Section 2.1.4 Environment Scenarios in the document

Suggestions for improvement: 

Swap bullet items 2 and 3:
"* Which installation method do you want to use? The Installation Methods section provides some information about the quick and advanced installation methods.
* How many pods are required in your cluster? The Sizing Considerations section provides limits for nodes and pods so you can calculate how large your environment needs to be.
* How many hosts do you require in the cluster? The Environment Scenarios section provides multiple examples of Single Master and Multiple Master configurations.
* Is high availability required? High availability is recommended for fault tolerance. In this situation, you might aim to use the Multiple Masters Using Native HA example as a basis for your environment.
* Which installation type do you want to use: RPM or containerized? Both installations provide a working OpenShift Container Platform environment, but you might have a preference for a particular method of installing, managing, and updating your services.
* Is my installation supported if integrating with other technologies? See the OpenShift Container Platform Tested Integrations for a list of tested integrations."

Additional information: