ko: describe how cross namespace references work

[pmalek]

Description

Fixes Kong/kong-operator#2946

Preview Links

https://deploy-preview-3775--kongdeveloper.netlify.app/operator/konnect/cross-namespace-references/

Checklist

• Tested how-to docs. If not, note why here.
• All pages contain metadata.
• Any new docs link to existing docs.
• All autogenerated instructions render correctly (API, decK, Konnect, Kong Manager).
• Style guide (capitalized gateway entities, placeholder URLs) implemented correctly.
• Every page has a description entry in frontmatter.
• Add new pages to the product documentation index (if applicable).

[netlify]

✅ Deploy Preview for kongdeveloper ready!

Name	Link
🔨 Latest commit	c2f6db9
🔍 Latest deploy log	https://app.netlify.com/projects/kongdeveloper/deploys/6949274eb77b240008be47af
😎 Deploy Preview	https://deploy-preview-3775--kongdeveloper.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[lmilan]

@pmalek should this use the release/operator/2.1.0 branch as base instead of main?

[pmalek]

@pmalek should this use the release/operator/2.1.0 branch as base instead of main?

Wasn't aware of it. Yes sure.

I've changed it and in that case we can proceed with reviewing this and merging since we're targeting the release branch.

[lmilan]

Do we have a list of resources that can be referenced?

[pmalek]

This is still a WIP but Kong/kong-operator#2936 tracks all of those.

This document will cover (in my eyes) all the references that we'll have (not only the KonnectGatewayControlPlane reference).

If you'd like to have a list of those then we'd have to add it in the next section (ControlPlane configuration).

The list itself can change (based on the output of 2936) so we might want to refine it later on when we're closer to 2.1. WDYT?

[lmilan]

sounds good, we can wait and add the list later, thanks!