fix(docs): update 7 Cilium / Gateway API reference links returning 404 - #23
Open
lowgiant wants to merge 1 commit into
Open
fix(docs): update 7 Cilium / Gateway API reference links returning 404#23lowgiant wants to merge 1 commit into
lowgiant wants to merge 1 commit into
Conversation
- 3 links for the Cilium URL scheme change (.html -> trailing slash) overview/component-overview, network/ebpf/lifeofapacket, network/concepts/routing - 1 link correcting the Cilium Gateway API path servicemesh/gateway-api/ -> servicemesh/gateway-api/gateway-api/ matches the form index.md:947 in the same document set already uses - 3 links for the Gateway API doc tree moving under /docs/ mesh/gamma/ -> docs/mesh/gamma/ mesh/ -> docs/mesh/mesh-overview/ concepts/api-overview/ -> docs/concepts/api-overview/ - Refresh last_update in the 4 changed files
Author
|
Hi @devfloor9, Cilium and the Gateway API moved their docs around. |
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.
Background
Cilium and the Kubernetes Gateway API changed their documentation URL structures, and seven reference links now return 404. Response codes were checked directly on 2026-08-29.
The same was confirmed against the published site: the four pages below were downloaded and compared, and the 404 links are still exposed on them.
Changes
benchmarks/cni-performance-comparison.mddocs.cilium.io/en/stable/overview/component-overview.html…/overview/component-overview/…/network/ebpf/lifeofapacket.html…/network/ebpf/lifeofapacket/…/network/concepts/routing.html…/network/concepts/routing/gateway-api-adoption-guide/cilium-eni-gateway-api.md…/network/servicemesh/gateway-api/…/network/servicemesh/gateway-api/gateway-api/gateway-api-adoption-guide/index.mdgateway-api.sigs.k8s.io/concepts/api-overview/…/docs/concepts/api-overview/service-mesh/gamma-initiative.mdgateway-api.sigs.k8s.io/mesh/gamma/…/docs/mesh/gamma/gateway-api.sigs.k8s.io/mesh/…/docs/mesh/mesh-overview/The
last_updateblock (date and author) was also refreshed in all four changed files.Cilium — from
.htmlextensions to trailing slashesThe Cilium docs dropped extension-based URLs in favour of directory-style ones. The paths themselves are unchanged, so only the extension needs replacing.
Gateway API — the whole doc tree moved under
/docs/gateway-api.sigs.k8s.io/sitemap.xmlshows the entire documentation tree relocated beneath a/docs/prefix./mesh/,/mesh/gamma/, and/concepts/api-overview/return 404 with no redirect./concepts/gamma/does resolve to 200, but only via a 301 through/docs/mesh/to/docs/mesh/mesh-overview/— it is an intermediate URL, and it collapses the two links into one page. To preserve the distinction the source made between the "GAMMA specification" and the "mesh adoption guide", the two canonical paths are targeted directly./docs/mesh/gamma/— GAMMA specification, goals, configuration patterns/docs/mesh/mesh-overview/— guide for applying Gateway API to mesh trafficExisting precedent in the repository
For the Cilium Gateway API link in
cilium-eni-gateway-api.md,index.mdin the same document set already uses the correct form.I matched that form.
Site impact
All of these are external links in a
## Referencessection or a figure-source caption. No prose and no build output structure changes./docs/benchmarks/cni-performance-comparison/docs/…/gateway-api-adoption-guide/docs/…/gateway-api-adoption-guide/cilium-eni-gateway-api/docs/…/service-mesh/gamma-initiativeThe corresponding English pages (
/en/docs/…) carry the same 404 links. They are left untouched per the i18n policy.Verification
curl -s -o /dev/null -w '%{http_code}'— all 200 without following redirects (2026-08-29)/bpf/,/network/clustermesh/,geps/gep-3567/, …) were also checked — all 200, so left unchangednpm run buildexits 0