Skip to content

Split install/any-kubernetes-cluster/ into multiple pages  #11

@omerbensaadon

Description

@omerbensaadon

What is changing? (Please include as many details as possible.)

We ought to split the main "install doc" (page referenced in title) into sections which necessitate "progressing" along the install path.

How will this impact our users?

When users first click onto this page from https://knative.dev/docs/install/ they will no longer see a "wall of text" and instead be shown each of the components of the install separately.

As far as users are concerned, this change will...

  1. will be a more digestible experience for users
  2. allows issues to be opened against portions of the installation docs instead of "the install doc"
  3. allow more information to be put in these sections without the page becoming unwieldy

Context

In order to understand where the road-blocks exist in our install process, we need more fine-grained data on where users are falling off the installation journey.

This change also tees us up to make changes to the language in each section and be able to measure how those changes impact completion rates.

Prototype

Any time you see an arrow in this prototype, it means there is a separate page with "Next" and "Previous" linking them together in the direction of the arrows.

Final Prototype:
Install Split Prototyping Final

Metadata

Metadata

Assignees

Labels

EpicEpics to group issuesInstallUX bugs and enhancements related to improve knative install experiencekind/enhancementkind/good-first-issueDenotes an issue ready for a new contributor.size/SDenotes a PR that changes 10-29 lines, ignoring generated files.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions