Skip to content

Add context as to why users need to add a Networking layer, add a recommendation for prototyping (development/install/any-kubernetes-cluster.md) #3377

@omerbensaadon

Description

@omerbensaadon

Expected Behavior

When a new users comes to the "Installing a networking layer" section of the YAML-based install page, they should understand why Knative Serving needs a Networking layer, what it enables them to do and should be instructed to choose the Networking layer they are most familiar with/is already installed in their cluster.

In the event users do not have a Networking layer they are familiar with (or the one they are familiar with is not supported in the documentation), we should make a recommendation as to which Networking layer to use strictly for prototyping purposes.

Based on a fairly lax Slack survey, I recommend we tell users Kourier would probably be easiest, while noting that production use-cases may work better with Istio.

Actual Behavior

When a new users comes to the "Installing a networking layer" section of the YAML-based install page, they are given no context as to why they are being asked to install Networking. Moreover, the Networking multi-select defaults to "Istio" which is a heavy-handed networking layer to use to "Get Started"

This sends users on a goose-chase through the Istio docs, where they leave the site at an average rate of 45% (15% higher than site average). In both rounds of interviews we did, we had a grouping of User Feedback which was titled "Istio! Arg!"

Steps to Reproduce the Problem

  1. Go to https://knative.dev/development/install/any-kubernetes-cluster/#installing-a-networking-layer
  2. Commence goose-chase

Additional Info

Additional context
Child issue of knative/ux#26 part of the ongoing efforts in knative/ux#1

Metadata

Metadata

Assignees

Labels

kind/good-first-issueDenotes an issue ready for a new contributor.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions