Skip to content

fix(docs): update 7 Cilium / Gateway API reference links returning 404 - #23

Open
lowgiant wants to merge 1 commit into
devfloor9:mainfrom
lowgiant:fix/broken-external-links-cilium-gatewayapi
Open

fix(docs): update 7 Cilium / Gateway API reference links returning 404#23
lowgiant wants to merge 1 commit into
devfloor9:mainfrom
lowgiant:fix/broken-external-links-cilium-gatewayapi

Conversation

@lowgiant

Copy link
Copy Markdown

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

File Line Before (404) After (200)
benchmarks/cni-performance-comparison.md 100 docs.cilium.io/en/stable/overview/component-overview.html …/overview/component-overview/
107 …/network/ebpf/lifeofapacket.html …/network/ebpf/lifeofapacket/
114 …/network/concepts/routing.html …/network/concepts/routing/
gateway-api-adoption-guide/cilium-eni-gateway-api.md 1819 …/network/servicemesh/gateway-api/ …/network/servicemesh/gateway-api/gateway-api/
gateway-api-adoption-guide/index.md 414 gateway-api.sigs.k8s.io/concepts/api-overview/ …/docs/concepts/api-overview/
service-mesh/gamma-initiative.md 106 gateway-api.sigs.k8s.io/mesh/gamma/ …/docs/mesh/gamma/
107 gateway-api.sigs.k8s.io/mesh/ …/docs/mesh/mesh-overview/

The last_update block (date and author) was also refreshed in all four changed files.

Cilium — from .html extensions to trailing slashes

The 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.xml shows the entire documentation tree relocated beneath a /docs/ prefix.

/docs/mesh/gamma/
/docs/mesh/mesh-overview/
/docs/concepts/api-overview/

/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.

Entry Target page
GAMMA Initiative /docs/mesh/gamma/ — GAMMA specification, goals, configuration patterns
Gateway API for Service Mesh /docs/mesh/mesh-overview/ — guide for applying Gateway API to mesh traffic

Existing precedent in the repository

For the Cilium Gateway API link in cilium-eni-gateway-api.md, index.md in the same document set already uses the correct form.

docs/…/gateway-api-adoption-guide/index.md:947
  - [Cilium Gateway API 문서](https://docs.cilium.io/en/stable/network/servicemesh/gateway-api/gateway-api/)

I matched that form.

Site impact

All of these are external links in a ## References section or a figure-source caption. No prose and no build output structure changes.

Published page Affected links
/docs/benchmarks/cni-performance-comparison 3 figure sources (Component Overview · Life of a Packet · Routing)
/docs/…/gateway-api-adoption-guide 1 resource-model figure source
/docs/…/gateway-api-adoption-guide/cilium-eni-gateway-api 1 reference
/docs/…/service-mesh/gamma-initiative 2 references

The corresponding English pages (/en/docs/…) carry the same 404 links. They are left untouched per the i18n policy.

Verification

  • The 7 replacement URLs checked with curl -s -o /dev/null -w '%{http_code}'all 200 without following redirects (2026-08-29)
  • The 7 original URLs all return 404 under the same conditions
  • The other 7 Cilium / Gateway API links on the same pages (/bpf/, /network/clustermesh/, geps/gep-3567/, …) were also checked — all 200, so left unchanged
  • The four published pages were downloaded and compared for the old URLs
  • Confirmed no occurrences of the old URLs remain anywhere in the repository
  • npm run build exits 0

- 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
@lowgiant

Copy link
Copy Markdown
Author

Hi @devfloor9, Cilium and the Gateway API moved their docs around.
7 reference links in docs/ are 404 now.
Checked each replacement with curl, before/after is in the description.
Take a look whenever you have time.

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.

1 participant