knative
Document on Knative.dev about installing via Gateway
What is changing? (Please include as many details as possible.)
Work is being done to get net-gateway-api to beta in Knative.
How will this impact our users?
In what release will this take happen (to the best of your knowledge)?
v1.6.0
Context
Link to associated PRs or issues from other repos here.
@carlisia we don't currently document any of the plugins from the knative sandbox on knative.dev (this looks like it might be one of those?)
Recently I think it was requested to add something for net-istio or net-kourier (can't remember which) but since these aren't on knative.dev at all yet, it was decided to document them where they are in the sandbox repo.
Can you suggest a user story for why and where this would be included on knative.dev? If not I think it should follow the same pattern, i.e. documented in the sandbox repo until we have a proper process for documenting sandbox items in the website.
Hey @abrennan89, thanks for double checking this.
I will close this issue then. If in the future we have a need and use case for adding the documentation to the site we'll create a new issue and explain the reason for the exception.
We absolutely document net-istio and net-kourier here, for example:
https://knative.dev/docs/install/yaml-install/serving/install-serving-with-yaml/#install-a-networking-layer
It's also mentioned here (possibly wrongly, it doesn't mention kourier or contour): https://knative.dev/docs/serving/knative-kubernetes-services/
Istio is also documented here: https://knative.dev/docs/serving/using-a-tls-cert/#manually-adding-a-tls-certificate and search claims 18 total pages with "Istio" on them.
@carlisia @evankanderson if this still needs to be documented please provide some draft docs / information.
@evankanderson re the above comment, I just meant we don't document specific mention of the plugins AFAIK, which makes things even more confusing, we just talk about needing a networking layer (those docs are already a mess IMO that need a good clean up) and istio etc as options scattered throughout docs.