Controller matching wizard by bexxmodd · Pull Request #4584 · kubernetes-sigs/gateway-api

bexxmodd · 2026-02-23T04:09:48Z

What type of PR is this?
/kind documentation

What this PR does / why we need it:
It's a controller matching wizard for the providers that submitted conformance reports. This should simplify operator/controller selection compared to peeking at the table's features.

You can run this by and test it locally at (http://localhost:8080/index.html):

make serve

Probably many things will require adjustment before this can be hosted, but it's good enough to try it locally for the initial feedback.

Which issue(s) this PR fixes:
Fixes #

Does this PR introduce a user-facing change?:

The new wizard should be available at https://gateway-api.sigs.k8s.io/wizard

xtineskim · 2026-02-25T16:33:44Z

🔥 🌟
this is great! I'm glad that the data from the table is being put to good use :)
I think the wording of Good to Have and Want to have could be a bit confusing, maybe something firmer, like Must have and Preferred?

nits/nice to have (non blocker)

a way to select the version
gateway api logo on the page somewhere? (lol) or a way to show the main menu? I know this may be tricky the way that this page is spun up/use of wasm 🤔

xtineskim · 2026-02-25T19:52:18Z

+# Feature definitions for the wizard: id and label match v1.4 conformance table columns
+# https://gateway-api.sigs.k8s.io/implementations/v1.4/
+FEATURE_DEFINITIONS = {
+    "httpGateway": [


more of a todo: will be worth getting the ids and labels generated rather than hard coded

Idk exactly how to do it. Feature names are not as descriptive in reports, so hard coded for later parsing.

Feel free to propose something

might be able to just get the label from the id, adding a space between the words. But this is not a blocker, so can be done in a later pr 👍

robscott

Thanks @bexxmodd!

…te/wizard

Co-authored-by: Rob Scott <rob.scott87@gmail.com>

bexxmodd · 2026-02-26T02:43:08Z

🔥 🌟 this is great! I'm glad that the data from the table is being put to good use :) I think the wording of Good to Have and Want to have could be a bit confusing, maybe something firmer, like Must have and Preferred?

nits/nice to have (non blocker)

a way to select the version

gateway api logo on the page somewhere? (lol) or a way to show the main menu? I know this may be tricky the way that this page is spun up/use of wasm 🤔

At the top wizard should have a drop-down menu for the latest three versions.
made it part of the docs, so it reuses the header and table list of the general page.

robscott

Thanks @bexxmodd, deploy preview looks great! Will defer to someone else for final LGTM.

k8s-ci-robot · 2026-03-04T19:29:52Z

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: bexxmodd, robscott

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

~~OWNERS~~ [robscott]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

youngnick · 2026-03-05T05:23:06Z

Yeah, I think this looks great.

/lgtm

* Add script to verify release artifacts. * Add \n * Add data extraction script and html for wizard. * Remove extra file. * Added wizard content. * Added hook to wizard data generation. * Removed redundant data json. * Convert wizard into an wasm app. * Remove data json file. * Exclude wasm from linter. * Limit versions to the latest three and rename Want to have -> Must have * Update site-src/wizard/controller-wizard.html Co-authored-by: Rob Scott <rob.scott87@gmail.com> * host wizard on k8s page. * Changed header and wording and update linter run to exclude wasm folder. * css adjustments to fit mkdocs. * typo for border. * Trying to pass golinter. * removed misplaced build directive. * Add boilerplate to go files. * Make adjustments to the wizard: added descriptions, subheadings, renamed recommend to match. * Go lint update. * Improve embedding of wizard into mkdocs. * css adjustments. * move feature groups around. * reset grpcecho.pd.go * space * Another space * Added random tiebreaker. * Replace math/rand with math/rand/v2 * Updated UI to improve UX. * changed wording of intro paragraph. * Prevent nested scroll bar from appearing. * Nest backendTLS in HTTPRoute. * update to ui. extended features only appear of the resource is selected. * updated wording. * fixed go linter errors. * replace specific version selection with minimum version selection. * remove note section. * extra white line between intro paragraph and selection. --------- Co-authored-by: Rob Scott <rob.scott87@gmail.com>

bexxmodd added 7 commits February 11, 2026 11:10

Add script to verify release artifacts.

bfef290

Add \n

da3be24

Add data extraction script and html for wizard.

481b107

Remove extra file.

cf0c1ff

Added wizard content.

e720253

Added hook to wizard data generation.

4d4b405

Removed redundant data json.

e69859e

bexxmodd requested review from robscott and xtineskim February 23, 2026 04:09

k8s-ci-robot added release-note Denotes a PR that will be considered when it comes time to generate release notes. kind/documentation Categorizes issue or PR as related to documentation. labels Feb 23, 2026

k8s-ci-robot requested review from candita and rikatz February 23, 2026 04:09

k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Feb 23, 2026

bexxmodd and others added 5 commits February 23, 2026 22:00

Convert wizard into an wasm app.

4a4e9e3

Remove data json file.

0def4ac

Exclude wasm from linter.

41bac1c

Merge branch 'kubernetes-sigs:main' into site/wizard

4ec5b8c

Limit versions to the latest three and rename Want to have -> Must have

e485333

xtineskim reviewed Feb 25, 2026

View reviewed changes

Comment thread hack/mkdocs-generate-controller-wizard-data.py

robscott reviewed Feb 25, 2026

View reviewed changes

Comment thread site-src/wizard/controller-wizard.html

Comment thread site-src/wizard/controller-wizard.html Outdated

bexxmodd and others added 5 commits February 25, 2026 13:58

Merge branch 'site/wizard' of github.com:bexxmodd/gateway-api into si…

fc49230

…te/wizard

Update site-src/wizard/controller-wizard.html

a6c70b6

Co-authored-by: Rob Scott <rob.scott87@gmail.com>

Good to have -> Nice to have

1a50e3d

host wizard on k8s page.

ddec234

Changed header and wording and update linter run to exclude wasm folder.

306f9dc

bexxmodd added 6 commits February 26, 2026 10:18

Improve embedding of wizard into mkdocs.

d4438e7

css adjustments.

f5691d1

move feature groups around.

4056b8f

reset grpcecho.pd.go

57b2421

space

ada61cd

Another space

785100e

howardjohn reviewed Feb 26, 2026

View reviewed changes

Comment thread wasm/main.go Outdated

Comment thread wasm/main.go

bexxmodd added 5 commits February 27, 2026 09:59

Added random tiebreaker.

4da6fd9

Replace math/rand with math/rand/v2

b6e6814

Updated UI to improve UX.

b79b39d

changed wording of intro paragraph.

bd4f9f8

Prevent nested scroll bar from appearing.

51a777f

bexxmodd mentioned this pull request Mar 3, 2026

Instrument Gateway API's webpage with GA4 #4626

Closed

bexxmodd added 6 commits March 2, 2026 21:17

Nest backendTLS in HTTPRoute.

8a2b0ea

update to ui. extended features only appear of the resource is selected.

58c2e37

updated wording.

a3d4c61

fixed go linter errors.

e51312b

replace specific version selection with minimum version selection.

61d443b

remove note section.

af652e4

robscott approved these changes Mar 4, 2026

View reviewed changes

k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Mar 4, 2026

extra white line between intro paragraph and selection.

ee503db

bexxmodd requested a review from xtineskim March 4, 2026 19:55

k8s-ci-robot assigned youngnick Mar 5, 2026

k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Mar 5, 2026

k8s-ci-robot merged commit f2ac7de into kubernetes-sigs:main Mar 5, 2026
20 checks passed

bexxmodd deleted the site/wizard branch March 5, 2026 21:38

Navigation Menu

Uh oh!

Controller matching wizard - #4584

Controller matching wizard#4584
k8s-ci-robot merged 42 commits into
kubernetes-sigs:mainfrom
bexxmodd:site/wizard

bexxmodd commented Feb 23, 2026 •

edited

Loading

Uh oh!

xtineskim commented Feb 25, 2026 •

edited

Loading

Uh oh!

xtineskim Feb 25, 2026

Uh oh!

bexxmodd Feb 26, 2026

Uh oh!

xtineskim Mar 2, 2026

Uh oh!

Uh oh!

robscott left a comment

Uh oh!

Uh oh!

Uh oh!

bexxmodd commented Feb 26, 2026

Uh oh!

Uh oh!

Uh oh!

robscott left a comment

Uh oh!

k8s-ci-robot commented Mar 4, 2026

Uh oh!

youngnick commented Mar 5, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Uh oh!

Conversation

bexxmodd commented Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

xtineskim commented Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

xtineskim Feb 25, 2026

Choose a reason for hiding this comment

Uh oh!

bexxmodd Feb 26, 2026

Choose a reason for hiding this comment

Uh oh!

xtineskim Mar 2, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

robscott left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

bexxmodd commented Feb 26, 2026

Uh oh!

Uh oh!

Uh oh!

robscott left a comment

Choose a reason for hiding this comment

Uh oh!

k8s-ci-robot commented Mar 4, 2026

Uh oh!

youngnick commented Mar 5, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

bexxmodd commented Feb 23, 2026 •

edited

Loading

xtineskim commented Feb 25, 2026 •

edited

Loading