Bug 1397996

Document URL: 
https://docs.openshift.com/container-platform/3.3/install_config/certificate_customization.html


Section Number and Name: 
Configuring Custom Certificates


Describe the issue: 
This sentence is not precise:

""The namedCertificates section may be listed in the servingInfo and assetConfig.servingInfo sections of the master configuration file or in the servingInfo section of the node configuration file.""


Does this mean 

(servingInfo[master] AND assetConfig.servingInfo[master]) OR servingInfo[node]

or does it mean

servingInfo[master] OR assetConfig.servingInfo[master] OR servingInfo[node]

or does it mean

(servingInfo[master] OR assetConfig.servingInfo[master]) XOR servingInfo[node]

or does it mean

(servingInfo[master] AND assetConfig.servingInfo[master]) XOR servingInfo[node]


I can't tell if the 'and' in 'servingInfo and assetConfig.servingInfo' is meant to be a list of options, or a logical && statement, because it says "may be listed" not "should be listed". In other words its not clear whether its necessary or even ok to list it in multiple places. Similarly, I am not sure if the 'or' in 'or in the servingInfo section of the node configuration file' is meant to be an inclusive 'or', an exclusive 'xor', or if it should possibly even be an 'and'. Furthermore, if it's an xor or an inclusive or, when would you decide to put it in one section(s) versus another section(s)? If it actually does not matter--that is to say, if the information can be placed in any combination of the three locations, to the exact same effect, we should be clear on that.

Suggestions for improvement: 
Use language that guarantees logical certainty. If this requires having multiple examples and explaining what they mean that's fine; if it just means using specific language that is also fine.