Skip to content

docs: replace relative markdown links with Hugo relref in concepts docs#8512

Open
Aditya7880900936 wants to merge 3 commits intoenvoyproxy:mainfrom
Aditya7880900936:fix-docs-absolute-links
Open

docs: replace relative markdown links with Hugo relref in concepts docs#8512
Aditya7880900936 wants to merge 3 commits intoenvoyproxy:mainfrom
Aditya7880900936:fix-docs-absolute-links

Conversation

@Aditya7880900936
Copy link
Contributor

What this PR does / why we need it

This PR replaces filesystem-relative markdown links in the site/content/en/latest/concepts/
documentation with Hugo relref shortcodes.

Using relative .md links can lead to broken navigation in the generated site because Hugo
generates routed URLs that do not match the repository directory structure. The relref
shortcode ensures that links are resolved correctly across versions, languages, and future
directory refactors.

This change improves documentation reliability and navigation consistency.

Scope of changes

This PR updates relative links only within the following concepts documentation pages:

  • concepts/api-gateways.md
  • concepts/gateway-api.md
  • concepts/load-balancing.md
  • concepts/proxy.md
  • concepts/rate-limiting.md
  • concepts/gateway_api_extensions/_index.md
  • concepts/gateway_api_extensions/backend-traffic-policy.md
  • concepts/gateway_api_extensions/client-traffic-policy.md
  • concepts/gateway_api_extensions/security-policy.md

Testing

  • Ran make docs locally
  • Verified successful Hugo build
  • Confirmed that updated links resolve correctly in local preview

Release Notes

No release note required (documentation-only change).

Fixes

Fixes #6061

@Aditya7880900936 Aditya7880900936 requested a review from a team as a code owner March 12, 2026 19:19
@netlify
Copy link

netlify bot commented Mar 12, 2026

Deploy Preview for cerulean-figolla-1f9435 ready!

Name Link
🔨 Latest commit add3678
🔍 Latest deploy log https://app.netlify.com/projects/cerulean-figolla-1f9435/deploys/69b3126c3754970008bcb847
😎 Deploy Preview https://deploy-preview-8512--cerulean-figolla-1f9435.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Signed-off-by: Aditya7880900936 <adityasanskarsrivastav788@gmail.com>
Signed-off-by: Aditya7880900936 <adityasanskarsrivastav788@gmail.com>
Signed-off-by: Aditya7880900936 <adityasanskarsrivastav788@gmail.com>
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.

Fix links in the generated Gateway API docs.

1 participant