better clarify namespace precendence on resource manipulation; clarif…

[gabemontero]

…y role of two repos

@wewang58 and @bparees - please review doc updates based on recent discussion we have had.

@dobbymoodge - I'll use this PR to test the changes we did recently on ci.openshift

[gabemontero]

@dobbymoodge - the ci.openshift change looked to me to have worked. Everything I was expecting seems to have occurred, but take a peek from your end and see if you agree.

[bparees]

couple nits, otherwise lgtm

[gabemontero]

comments from @bparees incorporated - thanks

@wewang58 - any chance you'll be able to confirm if these updates make the behavior clearer to you? I'll wait for a bit, see if you have a chance, before merging this.

Also, we'll keep the motivating issue open to sort through your attempts create resources in varying namespaces.

[bparees]

lgtm

[gabemontero]

thx @bparees