docs.konghq.com icon indicating copy to clipboard operation
docs.konghq.com copied to clipboard

Docs: direct users from KIC unmanaged Gateways site to KGO managed Gateways section

Open pmalek opened this issue 2 years ago • 2 comments

Problem statement

https://docs.konghq.com/kubernetes-ingress-controller/latest/concepts/gateway-api/#gateway-management described unmanaged Gateways with KIC.

This site should be directing users to KGO's managed Gateways section, possibly https://docs.konghq.com/gateway-operator/latest/get-started/kic/create-gateway/ or perhaps an extended version of that focused on Gateway API Gateways.

Acceptance criteria

  • [ ] As a User I can find a link in https://docs.konghq.com/kubernetes-ingress-controller/latest/concepts/gateway-api/#gateway-management directing me to KGO's managed Gateways doc describing that KGO can manage my Gateways.

pmalek avatar Jan 22 '24 18:01 pmalek

How about directing the "Gateway API" page to somewhere introducing managed gateway in KGO part, and keep the major part of the original page as "Unmanaged Gateway" as a sub-page of "Gateway API, and mark Unmanaged Gateway as "deprecated"? @mheap @pmalek

randmonkey avatar Mar 13 '24 09:03 randmonkey

I'm not sure if we want to mark unmanaged Gateways as deprecated.

We definitely want to direct users somehow from https://docs.konghq.com/kubernetes-ingress-controller/latest/concepts/gateway-api/#gateway-management to something like https://docs.konghq.com/gateway-operator/latest/concepts/managed-gateways/.

Feel free to change the AC @randmonkey since you've assigned yourself to the issue.

pmalek avatar Apr 19 '24 09:04 pmalek