Kong / gateway-operator

Kubernetes Operator for Kong Gateways
Apache License 2.0
50 stars 11 forks source link

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

Open pmalek opened 8 months ago

pmalek commented 8 months ago

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

randmonkey commented 6 months ago

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

pmalek commented 5 months ago

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.