feat(mesh): Mesh/Konnect docs revamp - #6512
Open
lmilan wants to merge 14 commits into
Open
Conversation
✅ Deploy Preview for kongdeveloper ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
There was a problem hiding this comment.
Pull request overview
Revamps the Kong Mesh + Konnect documentation IA and content by replacing older/orphaned reference pages with a dedicated landing page, new task-focused how-tos (UI/API/Terraform), reusable include fragments (deploy/validate/cleanup), and updated redirects/index entries to keep existing inbound links working.
Changes:
- Added a new “Kong Mesh in Konnect” landing page and updated Mesh/Konnect entry points to route users through the new structure.
- Replaced older Mesh-Konnect reference/how-to pages with new, more granular how-tos for Kubernetes/Universal via UI/API, plus migration/federation guides.
- Updated redirects and the Mesh index to reflect new permalinks and prevent orphaned content.
Reviewed changes
Copilot reviewed 39 out of 39 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| app/mesh/single-zone.md | Updates federation link to the new Konnect-focused federation how-to. |
| app/mesh/migrate-zone.md | Removes legacy reference page (superseded by new how-to + redirects). |
| app/mesh/konnect-global-control-plane.md | Removes legacy reference page (superseded by new how-tos + redirects). |
| app/mesh/import-existing-konnect-kong-mesh-deployment-to-terraform.md | Updates related resources to point to the new Konnect landing + new Terraform how-to permalink. |
| app/mesh/federate-zone.md | Removes legacy reference page (superseded by new how-to + redirects). |
| app/mesh/deploy-kong-mesh-using-terraform-and-konnect.md | Removes legacy Terraform reference page (replaced by new how-to). |
| app/_redirects | Adds/updates redirects from legacy Mesh-Konnect URLs to the new how-tos/landing page. |
| app/_landing_pages/mesh/konnect.yaml | New landing page explaining Mesh-in-Konnect architecture and linking to UI/API/Terraform guides. |
| app/_landing_pages/mesh.yaml | Updates Mesh landing page copy and CTA routing to new Mesh-Konnect quickstart/docs. |
| app/_landing_pages/konnect.yaml | Updates Konnect landing page “Get started” link to the new Mesh-Konnect Kubernetes UI guide. |
| app/_indices/mesh.yaml | Updates Mesh index to include the new Konnect landing page and new guide permalinks. |
| app/_includes/how-tos/mesh/validate-zone-online.md | New reusable validation steps for confirming a zone is online in Konnect. |
| app/_includes/how-tos/mesh/validate-mesh-zone.md | New reusable validation steps for confirming demo traffic/services via Konnect. |
| app/_includes/how-tos/mesh/reconnect-zone-to-konnect.md | New reusable steps to reconnect an existing zone CP to a Konnect-managed global CP. |
| app/_includes/how-tos/mesh/generate-zone-token-api.md | New reusable API steps for creating a system account + connector token for zones. |
| app/_includes/how-tos/mesh/deploy-zone-cp-universal.md | New reusable steps to deploy a Universal zone CP pointing at Konnect. |
| app/_includes/how-tos/mesh/deploy-zone-cp-kubernetes.md | New reusable steps to deploy a Kubernetes zone CP pointing at Konnect. |
| app/_includes/how-tos/mesh/deploy-demo-app.md | New reusable steps to deploy the Kubernetes demo app workloads/services. |
| app/_includes/how-tos/mesh/create-zone-ui.md | New reusable UI steps for creating a zone via the Konnect wizard. |
| app/_includes/how-tos/mesh/create-global-control-plane-ui.md | New reusable UI steps for creating a global control plane via Konnect. |
| app/_includes/how-tos/mesh/create-global-control-plane-api.md | New reusable API steps for creating a global control plane. |
| app/_includes/how-tos/mesh/apply-resources-to-konnect.md | New reusable steps for pointing kumactl at Konnect and applying exported resources. |
| app/_includes/faqs/mesh-zone-authentication.md | New FAQ content clarifying PAT vs system account token usage for zones. |
| app/_includes/faqs/mesh-configure-kumactl.md | New FAQ content for configuring kumactl via Konnect UI flow. |
| app/_includes/cleanup/mesh/uninstall-zone-cp.md | New cleanup include to uninstall the zone CP and namespace. |
| app/_includes/cleanup/mesh/remove-working-directory.md | New cleanup include to remove the working directory created by guides. |
| app/_includes/cleanup/mesh/remove-demo-app.md | New cleanup include to remove the demo app namespace/resources. |
| app/_includes/cleanup/mesh/delete-konnect-control-plane-ui.md | New cleanup include to delete a Konnect Mesh control plane via UI. |
| app/_includes/cleanup/mesh/delete-konnect-control-plane-api.md | New cleanup include to delete a Konnect Mesh control plane via API and remove system account. |
| app/_how-tos/mesh/migrate-self-managed-zone-to-konnect.md | New how-to for migrating zones from a self-managed global CP to a Konnect-managed global CP. |
| app/_how-tos/mesh/federate-zone-control-plane-to-konnect.md | New how-to for federating an existing single-zone CP into Konnect to enable multi-zone. |
| app/_how-tos/mesh/deploy-mesh-using-terraform-and-konnect.md | New Terraform how-to for provisioning Konnect mesh resources and deploying a Kubernetes zone CP. |
| app/_how-tos/mesh/deploy-mesh-self-managed.md | Adds a pointer to the new Mesh-in-Konnect landing page for managed model overview. |
| app/_how-tos/mesh/deploy-mesh-on-kubernetes.md | Adds a pointer to the new Mesh-in-Konnect landing page for managed model overview. |
| app/_how-tos/mesh/deploy-mesh-on-konnect.md | Removes legacy Konnect quickstart how-to (superseded by new UI/API how-tos + redirects). |
| app/_how-tos/mesh/configure-mesh-global-control-plane-on-universal-with-konnect-ui.md | New UI how-to for Universal zones. |
| app/_how-tos/mesh/configure-mesh-global-control-plane-on-universal-with-konnect-api.md | New API how-to for Universal zones. |
| app/_how-tos/mesh/configure-mesh-global-control-plane-on-kubernetes-with-konnect-ui.md | New UI how-to for Kubernetes zones + demo app workflow. |
| app/_how-tos/mesh/configure-mesh-global-control-plane-on-kubernetes-with-konnect-api.md | New API how-to for Kubernetes zones + demo app workflow. |
Suppressed comments (1)
app/_landing_pages/mesh.yaml:92
- Use sentence-case for common nouns here ("virtual machines" and "bare metal") to match the style guide and the rest of the page.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
lmilan
marked this pull request as ready for review
July 31, 2026 14:40
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Fixes #6329
Preview Links
Checklist
descriptionentry in frontmatter.