Skip to content

docs: complete v2 onboarding walkthroughs - #660

Merged
mjudeikis merged 1 commit into
kbind-dev:v2-nextfrom
olamilekan000:docs/v2-onboarding-walkthroughs
Nov 13, 2026
Merged

mjudeikis merged 1 commit into
kbind-dev:v2-nextfrom
olamilekan000:docs/v2-onboarding-walkthroughs

Conversation

@olamilekan000

@olamilekan000 olamilekan000 commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Summary

The kind setup guide writes kubeconfigs at the checkout root, but the quickstart looks under .kbind-quickstart/, so following the linked guides fails at binding. The core-only demo also creates its related Secret and ConfigMap directly on the consumer, which masks whether provider-to-consumer copying works.

  • Align quickstart kubeconfig paths and include the spec/status round trip.
  • Add a runnable backend-free walkthrough using the existing demo, with readiness waits, ownership checks, and cleanup.
  • Move related-resource samples to the provider manifest and update troubleshooting guidance.

Validation

  • Ran the backend walkthrough on disposable kind clusters: mock-OIDC login redirects, catalog, bundle apply, Connection/binding readiness, spec/status sync, related resources, and Widget deletion.
  • Ran the core-only walkthrough on fresh kind clusters with no backend or login service. Executed verification blocks directly from the guide and checked related-resource data and binding ownership.
  • Parsed the sample YAML and checked walkthrough shell syntax and generated links.
  • Generated the API/CLI references and built MkDocs with --strict (using the local Cairo library path on macOS).

Interactive browser launch was not tested; the mock-OIDC redirect flow was exercised with a cookie-preserving HTTP client.

What Type of PR Is This?

/kind documentation

Related Issue(s)

None.

Release Notes

Fix v2 quickstart kubeconfig paths and add a backend-free synchronization walkthrough with provider-owned related-resource samples.

Signed-off-by: olamilekan000 <odukoyaonline@gmail.com>
@mjudeikis
mjudeikis merged commit 85d2538 into kbind-dev:v2-next Nov 13, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants