Document URL: 
This page has room for improvements:
https://docs.openshift.com/container-platform/4.2/installing/install_config/installing-restricted-networks-preparations.html


Describe the issue:

 
#1 The sample in "Adding the registry to your pull secret", step 4
Edit the new file and add a section that describes your registry to it:

<original>
{
  "auths": {
    "cloud.openshift.com": {
      "auth": "b3BlbnNo...",
      "email": "you"
    },
    "quay.io": {
      "auth": "b3BlbnNo...",
      "email": "you"
    },
    "registry.connect.redhat.com": {
      "auth": "NTE3Njg5Nj...",
      "email": "you"
    },
    "<mirror_registry>": {
      "auth": "<credentials>",
      "email": "you"
    },
    "registry.redhat.io": {
      "auth": "NTE3Njg5Nj...",
      "email": "you"
    }
  }
}
...

<suggestion>
{
  "auths": {
    "cloud.openshift.com": {
      "auth": "b3BlbnNo...",
      "email": "you"
    },
    "quay.io": {
      "auth": "b3BlbnNo...",
      "email": "you"
    },
    "registry.connect.redhat.com": {
      "auth": "NTE3Njg5Nj...",
      "email": "you"
    },
    "registry.example.com": {
      "auth": "BGVtbYk3ZHAtqXs=",
      "email": "you"
    },
    "registry.redhat.io": {
      "auth": "NTE3Njg5Nj...",
      "email": "you"
    }
  }
}



#2 In the sample in "Adding the registry to your pull secret" , step 3:

<original>
cat ./pull-secret.text | jq .  > <path>/<pull-secret-file>

<suggestion>
cat ./pull-secret.text | jq .  > <path>/<pull-secret-file-in-json>


Additional information: 
Big portion of this page was removed from 4.4 / 4.5 doc.
https://bugzilla.redhat.com/show_bug.cgi?id=1877966