In https://gitlab.com/gitlab-org/gitlab/-/merge_requests/82246 we
introduced merged KUBECONFIGs for environments that have both agents and
clusters. This adds documentation for the new behavior, and describes a
workaround for older versions of GitLab.

See https://gitlab.com/gitlab-org/gitlab/-/issues/335089