Section Number and Name:
Allowing Pods to Reference Images from Other Secured Registries
Describe the issue:
A scenario that comes up often is users wanting to use "docker.io" as a private registry, however this no longer works with OpenShift Online due to the following bug which has been CLOSED WONTFIX. 
Suggestions for improvement:
Add a specific note/warning stating that "docker.io" cannot be used as a private registry with OpenShift Online.
Published content: https://docs.openshift.com/online/pro/dev_guide/managing_images.html#allowing-pods-to-reference-images-from-other-secured-registries